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GECOS III SMD TSS EXECUTIVE 


1. INTRODUCTION 


The GE-600 Time-Sharing System is one part of a two-part, integrated 
time-sharing--batch operating system that enables the user to do 
time-sharing and batch work simultaneously. The structure of the overall 
system allows variable allocation of resources to each mode of operation 
so that an installation with an established batch load can add on 
time-sharing capabilities without major disruption to the batch work. As 
the time-sharing system load grows, more of the overall system resources 
can be shifted from batch to the time-sharing work. 


This integration of time-sharing and batch systems provides significant 
capabilities for the user at the remote terminal since the design of the 
system permits the user to have access to both parts of the system. 
Using the conversational capabilities of the time-sharing system, a user 
can prepare input files to be submitted to existing batch programs. The 
output can be selectively scanned from the remote terminal. When the 
user is satisfied with the results, a compiete printout can be directed 


to a remote, high-sveed printer terminal if desired. 


The structure of the time-sharing system (TSS) is such that users are 
encouraged to add their own processing portion to the system. The 
general concept is similar to generating a slave program in the batch 
system. The services provided are directed toward time-sharing and 
remote terminal requirements. However, the interface is kept general and 
is designed to permit users or installations to readily develop 
extensions for their specific needs. 


The time-sharing system itself may logically be divided into two 
categories: the Executive and the subsystem programs. The time-sharing 
system Executive is a submonitor within the GE-600 Comprehensive 
Operating Supervisor (GECOS III). The GECOS system performs functions 
for subsystem programs such as allocation, dispatching, control of I/O, 
accounting for resources used, etc. The subsystem programs provide 
functions for the user similar to normal slave programs within the 
standard operating system. 


The executive portion of the system is core-resident (while time-sharing 
is active), and is made up of a number of subprograms (one of which is 
named Executive). The various subsystems are brought into the TSS 
allotted core area as needed to satisfy the user's requests. (The core 
size is set by the GE-600 central site console operator.) A separate 
copy of each subsystem is associated with each user, as required (i.e., 
subsystems are not reentrant). Several subsystems perform executive 
functions related to user log on and log off. 
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The overall time-sharing system flow of control is shown in Figure 1. 


The time-sharing system is a privileged slave program within the GECOS 
system. 


A MME GELBAR is used to dispatch to the subsystems. The return (fault, 
timer runout) is to a point in the TSS Executive where the cause is 
determined and appropriate action is taken. In all cases, the IC and I 
and registers are saved for the subsystem. A derail fault originating 
from a subsystem is interpreted as a request for service by the TSS 
Executive. For other fault returns, it is determined if the subsystem 
will handle faults. If such is the case, return is made to the subsystem 
(MME GELBAR); otherwise, the fault is interpreted as an error and a 
message sent to the terminal. However, certain type errors (e.g., 
parity, lockup, or op-not-complete) are considered as system errors. If 
a subsystem has exhausted its quantum of time, the Executive is entered 
to examine the status of remote I/O and up-date status of all users 
based on this input or output. It then goes through a_ selection and 


swapping procedure, subsequently dispatching the processor to a 
subsystem in core. 


A fault occurring within the time-sharing system Executive itself is a 
program error. In this case, recovery for a limited number of times is 
attempted before the system aborts. The current state of a subsystem's 
registers, instruction counters, and indicators is kept within the 
subsystem's data area. These values are set on initial entry to the 
Executive and may be used by any of the ensuing processes. 
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Figure 1. Time-Sharing System Flow of Control 
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2. SUBPROGRAM DESCRIPTIONS (EXECUTIVE) 


The Time-Sharing Executive (.MTIMS) module is composed of subprograms as 
follows: 


e TSSA Communication Region 

e@ TSSB Trace of Events 

e TSSC Swap Space Allocator 

e TSSD PAT Manager 

e TSSE TSS Exit 

e TSSF System Error 

e TSSG Print Error Comments 

e TSSH Control of User Processes 
e TSSI TSS Utility Routines 

e TSSJ Line Service 

e TSSK Derail Processors 

e TSSL Allocate Time/Space 

e® TSSM Executive 

e TSSN UST Generator 

e TSSO DATANET* 760 and Startup 


*Trademark 
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Communication Region Communication Region 
TSSA TSSA 


COMMUNICATION REGION (TSSA) 


The Communication Region in the time-sharing system provides a common 
area in which to store parameters used throughout the system. An effort 
has been made to collect all storage of parameters (including those 
within individual routines) into this area. Some of the parameters 
require initialization at TSS start time; this initialization is 
provided by TSTART, which loads data into these cells when required at 
time-sharing startup time. Each program references these parameters from 
a common communications definition macro which defines the regions with 
BSS's rather than data definitions. With this procedure, only one deck 
is required to initialize any of the parameters. If the data layout in 
the Communication Region is changed, a new Communication Region macro 
must be defined and each routine reassembled. 


UST Assignments 


The assignments for the User Status Table (UST) are defined in the 
Communication Region by EQU pseudo-operations. The location symbols’ and 
their contents are shown below. A detailed description of UST appears in 
the Introduction and System Tables SMD, CPB-1488. 


.LID 
-LSTP 
. LTP 
. LSTIO 
.LTIO 
. LTIN 
»LSNUB | SNUMB of batch job waiting 

.LBUF [ Buffer. ——sS—s—~<CS~s—“—;sC‘CS;S*SSCSCéA| +S * Station ID OCS 
.LIOST 
- LCC Courtesy call return 

. LBACK 
.LELAG | Forward pointer ——S=—s—S—<i Fags. COC~C~C—CSCSCSCSCSCSCSCSCSCSC“CSCS*S 
. LDAT 
.LFILE 
.LTTYS 
. LSWTH 
.LSZE 
. LSWAP 
. LERRM Zero 

-LCFIL 
. LSYBC 
. LSTEM 
»-LCALS | CALLSS pushdown list 

, LTALC 
-LTPSS | Processor time at subsystem start 


*B 
bad 


Buffer Tally, 1 bit 
Terminal Type, 5 bits 


Communication Region 


TSSA 


.-LKYSS 
-LDCSS 
~LSPTS 
- LTPS 

- LTIOS 
. LTSSV 
. LFLG2 
» LSFT™ 
- LKEYO 
» LSPRT 
- LTRM 

- LINNO 
- LINCR 
. LTDES 
-LCCTR 
- LBPTR 
- LSCLP 
» LCHG 

LIMIT 
- LACPT 
.LIMTR 
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Communication Region 
TSSA 


Key I/O count at subsystem start 

Disc i/O count at subsystem start 

Sum of processor time this subsystem interaction 
-LTP at last swap 

-LTIO at last swap 

savea I/O status 

Second flag word 

4-word LINSRV pointer disc/drum R 

Time of Key I/O start 

Sum of processor time in subsystem 

Terminate courtesy cal] 

Line number for auto mode 

Increment for auto mode 

File description of PPT 

DATANET 760 character count 

DATANET 760 buffer pointer 

Line Service previous current line pointer 
= character BCI charge number 

Subsystem time limit set by user 

Accept indicator for privileged subsystem (Lodx and Cardin) 

Time limit timer 


Parameters / Variables 


The following are lists of the narameters or variables in the 
Communication Region with explanations of their functions. 


» LXXXX 
- LBKMX 
- LBUFS 
-LFILS 
- LPRSS 
. LPRGS 
- LPRGD 
- LNTSF 
- LNDRC 
. LLNUE 
. LADCW 
. LNPD 

-LLTOT 
- LLMAX 
. LLWFE 
» LRMAX 
-LSNIO 
~LFPES 
~LFPAT 
. LPSZ 

- LNEVT 
« LBRT 

- LBRK 


Number of items in UST 

Block number threshold for scratch file 
Number of words in line buffer 

Max. number of entries in file table 
Number entries in CALLSS pushdown list 
Number entries in pushdown list 

Number entries in program descriptor 
Number of TSS executive files 

Number of entries in DRL count table 
Number of words per UST entry 

Max. number swap DCW's 

Number of entries in program descriptor list 
Number of new users per cycle 

Max. number of users (180) 

Number of words per file table entry 
Number of system errors allowed before abort 
Number of I/O queues for TSS 

TSS user basic PAT entry size 

Number of TSS user PAT's 

Size of subsystem patch area 

Number of entries in trace table 
Location of abort, reason code 

Break fault 
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Communication Region Communication Region 
TSSA TSSA 


~LSZTM Size and Time exceed fault 

.LBRTM GELBAR time setting 

-LOSTI Offset for subsystem indicators 

. LRAP Wrapup address 

-LFTST Accumulated fault status 

-LOSTR Offset for subsystem register 

-LASTT Swap I/O status - 2 words 

-LADW1 Swap DCWl and block number cell 

»~LADW2 Swap DCW2 list 

.~LASWP Core map entry, UST pointer for swap in 


The list below is ordered according to the location of the cells in the 
Communication Region block, .TSCOM. 


The areas, .TAMAP through .TAREA, are overlayed by MAIN (TSSO) to 
facilitate reading in large systems such as BASIC and FORTRAN. At the 
conclusion of startup, these areas are reinitialized. 


PARAMETER SIZE 
VARIABLE OF 
NAME CELL DESCRIPTION 

-TCFST 0 (Null) Origin of common region. 

.- TCLOC 1 Cell contains location of user's data region 
and procedure entry at time of actual 
aispatch to a subsystem. 

.TMAT1 1 Temporary storage cell for MAS2 subsystem. 

- TESSB 1 Upper portion contains relative base within 
time-sharing system for current subsystem in 
operation. The lower portion contains pointer 
to UST of present user in execution. Set only 
when passing control to subsystem program. 

. TEPTS 1 Contains processor time upon entry to. the 
subsystem program. Used to determine if 
direct return should be made to subsystem 
program if Executive regains control before 
its quanta of time has elapsed. Also used for 
accounting purposes. 

. TELAL 1 When control is given to subsystem program, 


is set to initial address within time-sharing 
system of the subsystem. The modifier portion 
of word contains an index-register-one 
modification used to reference areas within 
subsystem program. 


Communication Region 


TSSA 


-T760 


~TCPRT 


- TOSNB 


. TCDEL 


-TCBSZ 


«TCUST 


-TCPD 


+1 


- TLTYN 


»TLTTM 


- TLOLD 


.- TLNRJ 


- TLTLM 


j— 
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Communication Region 


TSSA 
Unner nortion contains ciga of euhevetam 
bee mal lll Pong Re de ee ed a ke eet ee wT ae eI Adi od Y to Wow’ 
program. Used to check that addresses 
specified by program are within range of 


subsystem program. All addresses, calling 
sequences, etc., are checked before they are 
used during processing of derails. 


Upper portion contains the number of DATANET 
760's allowed access to TSS. 


Contains processor time upon entry to 
Executive. Set each time Executive regains 
control. 


Contains original SNUMB for batch jobs. Set 
at startup time. 


Contains incremental limit on time of day for 
direct return to subsystem. 


Contains in its upper portion size of the 
line buffers associated with each user. 


Lower portion contains a pointer to first 
User Status Table and upper portion contains 
a pointer to the last User Status Table in 
Upper portion contains a pointer to initial 
program descriptor. Lower portion contains 
number of program descriptors present in 
table. 


Temporary storage for MAS2 subsystem. 


Upper portion contains number of entries that 
will be processed by Line Service in one 
cycle. In lower portion, Line Service 
maintains a pointer for continuation of its 
scan made during each cycle. 


Time of day Line Service last executed remote 
line terminate scan section of Line Service. 


Unused. 


Time of day Line Service last executed new 
user log-on procedure. 


Upper portion contains number of users in 
reject queue and presently waiting for 
disconnect. 


Time interval used to permit execution of 
remote line terminate scan in Line Service. 
(.5 sec.) 
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Communication Region Communication Region 

TSSA TSSA 

.TLNLM 1 Time interval used to permit execution of new 
user log on procedure in Line Service. (.3 
sec.) 

.- TCNOU 1 Upper portion contains maximum number of 
users on time-sharing system and lower 


portion contains the current number of users 
on system. 


- TRCNT Z Count of the number of serious errors that 
have occurred in time-sharing system. If 
count exceeds 5, time-sharing system will be 
aborted. In general, some recovery is 
attempted from all system errors but if a 
series of system errors occurs, whole system 
is aborted. 


.- TABFN 1 End-of-allocation queue backwards (0). 


-TAFST ae Upper contains start-of-allocation queue 
forwards; pointer to first entry in queue. 


- TABST ak Upper contains start-of-allocation queue 
backwards; pointer to last entry in queue. 


.» TAFFN 1 End-of-allocation queue forwards (0). 
- TAMSZ 1 Contains number of entries on the drum _ swap 


map. Justified to the left to be loaded into 
register 0 as repeat instruction. 


. TLFLG A: Line Service flags. Bit 35, no new jobs’ can 
be accepted; bit 34, status request; abort in 
process. 

- TCTM1 1 Series of scratch storage cells used by any 
. subroutine.Not maintained across call from one 
< each subroutine to another and must not be used for 
- long term storage data. Not used at courtesy 

- TCTM9 call level or during initial entry to Executive. 

- TMAT 1 Temporary storage for MAS2 subsystem. 

- TPNTP 1 Temporary storage for Print Error Comments. 

- TQSYS 1 Count of times user may have hit break key 
during log-on. 

. TTERM 1 Count of user terminations. 

- TOQEXC z Count of passes through Executive. 

-TASIO - Count of swaps for keyboard I/O. 

-TSSTR Hf TSS startup time. 
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Communication Region Communication Region 
TSSA TSSA 
ISTRT 1 Count of subsystem starts. 

- TKILL 1 Count of subsystem kills. 

. TSWAP 1 Count of subsystem swaps. 

. TSWPK A Sum of swapped core sizes/1024. 

- TLUCT Hl Count of users accepted. 

+1 1 Count of users rejected. 

. TLNAA 1 Count of number of relinquishes because 
neither the Allocator nor Line Service is 
busy. 

. TLBDC 1 Count of breaks. 

+1 1 Count of disconnects. 

~TLNCT 1 Count of times alarm clock set when no users. 

. TACUT i Sum of user log-on time. 

. TAURG i Number of urgent users. 

.TLDID di: Number of duplicate line ID's. 

. TLMON 1 Contains pointer to the master UST in upper 


and pointer to the UST of the line being 
monitored in lower. 


. TESNB 1 Current SNUMB. Used for batch jobs. 
- TCDAT 1 Current date in BCI. 

-TDRDR 1 Read command for #S. 

-TDRDT 1 Read command for #T. 

.»TDWDR 1 Write command for #S. 

»TDWDT 1 Write command for #T. 

-TAUST 4 Used by Dynamic UST module. 

- TSDAT 1 Startup date. 

~TSTOD a Time of day. 

.- TAAUG 1 Accumulative count of urgent users. 
. TLGRF 1 Line Service flag for MME GEROUT. 

. TDBLK 1 Block size of #S. 

- TDBLT 1 Block size of #T. 
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Communication Region 
TSSA 


-TASSZ 1 
.TASTM 2 
. TDSPC i 
. TDSPL x 
. TDREL 1 
« TDREC 1 
- TDSPD 1 
- TACOR a 
» TAMPT 1 
. TAHOL 1 
. TAMAP 2 xX maximum 


number of users 


~TSMPT Patch table 
size + 12 


- TSREG 8 
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Communication Region 


TSSA 
Installation-settable subsystem size 
limitation. 
Installation-settable subsystem processor 
time limitation. 


Upper portion contains count of MME GEMORE's 
issued; lower contains count of DRMSPC 
module calls. 


Sum of all #S file links requested via MME 
GEMORE. 


Sum of #S file links released. 


Upper portion contains count of MME GERELS 
issued; lower contains count of RELSPC calls. 


Number of denials. 


Initial and final address of available TSS 
core used for swap area. 


Forward (upper) and backward (lower) pointers 
of entries in core map of subsystems loaded. 


Upper half contains pointer to first empty 
slot in core map. If there is request for 
change in core size, requested size is in 
lower half. 


Core map is made up of two-word entries. 
word 1: 0-17 


18-26 
27-35 


pointer to next entry or 0 
K/2 of core used by SS 
Size of unused hole 


word 2: 0-8 
9-17 
18-35 


initial address of loaded SS 
index to previous map entry 
UST pointer 


When not being used, word 1 contains pointer 
to next empty slot and word 2 = 0. 


Subsystem patch area constructed by MAST 
subsystem. 


Upon entry from GECOS III, Executive stores 
registers as saved by GECOS III when 
interrupt occurred. They are then passed on 
to subsystem in execution or loaded if in 
executive mode. 


GECOS III SMD TSS EXECUTIVE 


Communication Region Communication Region 
TSSA TSSA 
- TLNUQ 2 xX number New user queue. New user is held in queue and 
users to be is either accepted or rejected depending upon 
processed status of time-sharing system. Only limited 
per cycle number of users per cycle will be logged onto 


time-sharing system and each must pass through 
queue before being accepted or rejected by 
system. 


- TRQUE 2 per entry Queue contains user error entries that have 
occurred up to time time-sharing system has 
been aborted. Upper portion of first word 
contains UST entry address. Second word 
contains error code. 


- TCCMT 30 Common message buffer. 

» TDDRL maximum Series of cells in which count is kept of 
number of number of times each derail is called. (.LNDRC 
derails table of derail counts.) 

. TADMP 2 xX maximum Map of the drum used to swap user's programs 
number of users on and off drum. Each map entry contains 
plus l information in two words. First word contains 

number of blocks in a region.Lower portion of 
first word contains the size of residual hole 
for this block. Upper portion of second word 
contains initial block number for this regicn. 
Lower portion of second word presently not 
used. 

. TADMT maximum number Map for secondary swap file #T. 


of users/2 


. TEVTB event entries-2 Trace table; 2 words per event entry. 
.- TAREA Hf Pointers for TSSO use, initialization. 
.» TFMAX al Lower portion contains maximum number of 


users. Set by installation, 


. TFPPE qd Upper portion contains offset address to 
beginning of PAT pointers in SSA2; lower 
contains number of PAT entries provided for 
(initialized by startup). 


.TFTEM i Device type for temporary user files (bits 
0-6) ° 
» TFSY 5 File description of SY**, 
~TFSKL 10 Area used by file routines to build PAT's. 
. TFBLK (maximum SY** assignments. 
numbers of 


users) /6 + 2 
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Communication Region 


TSSA 


-TSTRC 


. TEVNT 


+2 


. TEVMK 


oTCTPT 


-TCTSZ 


~TCTDC 


. TDSKS 
« TDSKT 
~TATSZ 


DVTB1 


DVTB2 


ePCril 


- TCLST 
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2 xX number of 


event entries-2 


2 


20 


20 


20 


2 xX number 
of TS files 


GECOS III SMD TSS EXECUTIVE 


Communication Region 
TSSA 


Entry to the trace event routine. 


Tally and refresher tally for the trace table 
(.LNEVT). 


Trace table; 2 words per event entry. 


Mask of events to be traced (1) or not 
traced (0). 


Table of interaction counts versus processor 
time intervals. 
Table of interaction counts versus program 


size. 


Table of interaction counts versus number of 
disc I/O's performed. 


Seek command for #S. 
Seek command for #T. 
Number of entries in #T swap map. 


Device table 1 is used by TSS startup when 
space is not available as specified in 
-TCFIL. Space will be acquired from the first 
device in this table which has room. 


Device table 2 is initialized at startup so 
that any device which does not exist is set 
zero. File space for SY** and other user's 
temporary files is acquired on the first 
device in this table which has room. 


TSS system files. 


3 
Ww 


word 2 0-5 = device type 
6 = lock bit 
7 = 0/1 or temp/perm 
9-17 = no. links/file 
18-35 = no. words/block 
Unused 


End of communication region. 


GECOS III SMD TSS EXECUTIVE 


Communication Region Communication Region 
TSSA TSSA 


Program Descriptor Region 


The TSSA module aiso contains a Program Descriptor area in block .TPRGD. 
This area is physically divided into two. sections: the program 
descriptor and the command language primitive iist. 


The program descriptor format consists of nine words in the _ following 
order: 


e 


Subsystem name in ASCII 

Program size, load size 

Entry point, parameters 

Seek address (#P), IA load 

Command language pointer, number of words in CL 
Program statistics 

Sum of processor time 

Sum of disc I/O counts 

Sum of key I/O counts 


WONDOBRWDN 
e 


The Program Descriptor area is described in detail in the GE-600 Line 
GECOS III Time-Sharing Programmer reference manual, CPB-1514. 
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GECOS III SMD TSS EXECUTIVE 


TRACE OF EVENTS (TSSB) 


The Trace of Events (TSSB) updates the system trace table and gathers 
accounting statistics which are not entered in the table. 


TSSB contains one entry point: 
e EPIL Trace Recent Events (TSEVNT) 


TSSB occupies approximately 330 (octal) core storage locations. 
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GECOS III SMD TSS EXECUTIVE 


TSEVNT (EP 1) TSEVNT(EP1) 
TSSB TSSB 


TRACE RECENT EVENTS 


ecent events of the 


TSEVNT (EP1 of TSSB) maintains a trace of the most r 
ithout making entries 


time-sharing system and also gathers statistics w 
in the trace table. 


CALLING SEQUENCE 


TSEVNT is called from TERM, TRMCU, KEYIO, SYS, STARTP, SCAN1, SCAN3, 
LINSRV, GOOD10, STG76, EXDRL, SYSRET, ALLOC, ALLOCI and SWAP via: 


8 16 
T 


EVENT levent number 
which generates the code: 


j AUC jetoTRC 
| ZERO yname ,0 


~TSTRC contains: 


XED }ISEVNT 
| 


OPERATING SYSTEM INTERACTION 
No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Returns to calling program. 


POSTCALLING SEQUENCE 


None. 
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GECOS III SMD TSS EXECUTIVE 


TSEVNT (EP 1) TSEVNT(EP1) 
TSSB TSSB 


SUPPORTING INFORMATION 


ct «t+ 


ally words are 
tally word. These 


The trace table is a 2-word entry, circular table. Two 
used to drive it, a current tally word and a refresher 
words and the table are in the Communication Region. 


The format of the table entries is: 


word lL Available to user 


However, the user-provided code must do this. A routine in TSEVNT, USER, 
computes the user number by sequence in UST storage, and moves it to the 
proper position in the Q. Then the user can provide the event number and 
whatever else is desired in the A and Q. Another routine, STORE, puts 
the AQ in the table as a 2-word entry and refreshes the tally if 
necessary before returning to the time-sharing system, 


A 2-word mask (.TEVMK) is maintained against which a test can be made of 
up to 72 events. A zero in the mask inhibits the trace on that event 
number. The mask can be modified from the master terminal. 


The following table lists the EVENT's and the corresponding trace 
entries which exist in the current system. 
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TSEVNT (EP1) TSEVNT(EP1) 
TSSB TSSB 
EVENT 
No. Source word 1 Word 2 

) 1718 35 0 1718 2627 35 


j- 
3 
ba 
byl 
s 
P< 
py] 
on 
- 
Hy 
bE 
Hed 
Q) 
1e) 
hf 
ct 
nN 
Gc 
n 
@ 
K 
ht 


2 KEYIO XR1 I/O Mode user 2 

3 SYS XR1 Station juser 3 
Code 

4 STARTP ASCII Name XR1 user 4 

6 LS TOD No. o£ 6 
users 

7 LS (new user) | TOD user 7 

8 SCAN ASCII Command user 10 

2 DRL DRL op DRL Loc juser | A 

| | | 


i 
i ALLUC eee | | 
i j 


jusex 


i 
i) 


tt fiw (At bd) 
12 ALLOCI (New) | C(.LSIZE) 


13 ALLOCI (Old) | C(.LSIZE) 


The following EVENTs gather statistics on the system but do not make 
entries in the trace table. 


14 KEYIO Collect interaction counts. 

16 SCAN ,DRi Collect subsystem usage. 

17 ALLOCI Accumulate swap count and swap sizes. 
18 TERM Accumulate users' log-on time. 
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GECOS III SMD TSS EXECUTIVE 


TSEVNT (EP1) TSEVNT(EP1) 
TSSB TSSB 


Programming Method 


TSEVNT is nonreentrant and relocatable. 


Interrupts are inhibited throughout. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Provide Date and Time of Day FGTIM (EP8 of .MFALT) 
Obtain Normal Snapshot GESNIP (EP1l of .MSNP1) 
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GECOS III SMD TSS EXECUTIVE 


SWAP SPACE ALLOCATOR (TSSC) 


The Swap Space Aliocator (TSSC) manages the swap space on the #S and #T 
files. It contains three entry points. 

@ EPI Request Drum Space (DRMSPC) 

e@ EP2 Return Drum Space (RETSPC) 

e EP3 Release #S Links (RELSPC) 


The drum map (.TADMP) consists of two-word entries as follows: 


Word 1 Number of blocks in use 
Word 2 Initial block number 


TSSC occupies approximately 510 (octal) core storage locations. 
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GECOS III SMD TSS EXECUTIVE 


DRMSPC(EP1) DRMSPC (EP 1) 
TSSC TSSC 


REQUEST DRUM SPACE 


DRMSPC (EP1 of TSSC) searches the #S map to find a hole to fit the 
request with the least amount of waste space. Unless it is at the end, 
entries following the hole space are moved down to create a new entry in 
the proper location in the map. If space is not available, an attempt to 
increase the size of #S is made with GEMORE. 


If this is unsuccessful, space is found then on #T, the secondary swap 
file. Normally #S is on the fastest device available and #T is on a less 
desirable device. Therefore, only as a last resort is #T used. 


PRECALLING SEQUENCE 


Prior to entering DRMSPC, the registers listed must contain the data 
indicated. 


AU Size required (in words) 


CALLING SEQUENCE 
DRMSPC is called from ALLOC, ALLOCI, ALL7AC and DYUST via: 


8 16 
i] 
TSX1 |DRMSPC 
Error return 
Normal return 

1 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 
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GECOS III SMD TSS EXECUTIVE 


DRMSPC(EP1) DRMSPC(EP1) 
TSSC TSSC 


ROUTINE RETURNS 


DRMSPC returns to the calling program. Error return indicates no room 
available. 


POSTCALLING SEQUENCE 


AU contains initial block number, if normal return. 


SUPPORTING INFORMATION 


Programming Method 


DRMSPC is nonreentrant and relocatable. 


Interrupts are inhibited throughout. 


storage 


No internal temporary storage is used. 


Other Routines Used 


Communication Region (TSSA) 
Let Slave Program Enter Master Mode FEMM (EP10 of .MFALT) 
Additional Mass Storage Request MINK (EP2 of .MMORE) 
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GECOS III SMD TSS EXECUTIVE 


RETSPC (EP2) RETSPC (EP2) 
TSSC TSSC 


RETURN DRUM SPACE 


RETSPC (EP2 of TSSC) searches .TADMP for the matching initial block 
number. If not found, the request is ignored. When found, the hole of 
previous entry is adjusted and the entry removed from the map by moving 
all the following entries up. 


PRECALLING SEQUENCE 


Prior to entering RETSPC, AU must contain the initial block number 
returned by DRMSPC or no action will be taken. 


CALLING SEQUENCE 


RETSPC is called from ALLOC and ALL7AC via: 


8 16 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


RETSPC returns to the calling program. 
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GECOS 


RETSPC (EP2) 
TSSC 


POSTCALLING SEQUENCE 


None. 


Programming Method 


RETSPC is nonreentrant. 


III SMD TSS EXECUTIVE 


RETSPC(EP2, 
TSSC 


Interrupts are inhibited until processing is complete. 


storage 


Internal temporary storage is used for saving registers and working 


storage. 


Other Routines Used 


None. 
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GECOS III SMD TSS EXECUTIVE 


RELSPC (EP 3) RELSPC (EP 3) 
Tesc TSSC 


RELEASE #S LINKS 


RELSPC (EP3 of TSSC) examines the size of #S in order to release 
unneeded links to the system. When hole space exceeds ten percent of the 
total size of #S, as many links as possible are released from the end of 
the file via MME GERELS. The minimum retained for #S is the number of 
links assigned at startup initialization. 


PRECALLING SEQUENCE 


None. 


| 
|RELSPC 
J 
| 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


RELSPC returns to the calling program. 
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RELSPC (EP3) 
TSSC 


POSTCALLING SEQUENCE 


SUPPORTING INFORMATION 


Programming Method 
RELSPC is nonreentrant and relocatable. 


Interrupts are inhibited throughout. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


MME GERELS Processor RELS (EP1 of .MRELS) 


GECOS III SMD TSS EXECUTIVE 


RELSPC(EP3) 
TSSC 
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GECOS III SMD TSS EXECUTIVE 


PAT MANAGER (TSSD) 


The PAT Manager (TSSD) manages the user's Available File Table (AFT) and 
Peripheral Assignment Table (PAT) entries in the Slave Service Area 
(SSA). It provides a common routine that can be used by the various File 
I/O derails to maintain each user's threaded list of open files. The 
combined AFT and PAT entries representing an open file in a user's’ list 
is called a "file entry." 


TSSD contains three entry points. 


e EPIL File Entry Space Allocation (PATMAN) 
@ EP2 File Deallocation (PATDEA) 
@ EP3 Delinking a File (FREE) 


TSSD occupies approximately 510 (octal) core storage locations. 


TSSD manages either most or all of the space in SSAs 2-7, depending upon 
whether any I/O queues (additional to those in SSAl1) exist at the 
beginning of SSA2, i.e., high-order end. 


In either case, the area managed by TSSD is essentially divided into two 
sets of discrete spaces. One set is a single-chained list of available 
spaces (usually scattered throughout the whole area) called the 
"available space chain". The high-order word of each variable-size 
element of the chain describes the number of words available in the 
element (going towards low-order memory), including itself, in its upper 
half; and contains a pointer to the next element in the chain in its 
lower half. The origin of this chain is the lower half of the first word 
of PATMAN's area, which cell is pointed to by the Communications Region 
cell .TFPPE, upper. (All pointers in this discussion are negative 
offsets from the LAL of TSS.) 


The second set of spaces is a collection of user's open-file lists, each 
list consisting of from 1 to (nominally) 20 file entries double-chained 
together. Each list is open, the backward and forward pointer at either 
end of the list being null (0), and the "first" entry in each list 
(backward pointer null) is pointed to in the lower-half of the file-list 
pointer word in each corresponding UST. (Bits 12-17 of this word contain 
a count of files currently open for that user, i.e., the current number 
of entries in the list pointed to.) This word is pointed to in turn by 
-LFILE lower, also in the UST. 


The size of each file entry varies from 8 to 16, according to current 
practice. The upper limit on the number of entries in a file list, 20 as 
released, is an assembly parameter that is specified in .LFILS, in TSSA. 


TSSD manages the transfer of elements from one set of spaces to the 
other. It transfers from the available-space chain to a user's file list 
(PATMAN entry) or vice-versa (FREE), besides releasing or deaccessing 
files (PATDEA). 
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See we ee we Oe es es ae te ke Ne WY Be KABSS 


PATMAN (EP 1) PATMAN (EP 1) 
TSSD TSSD 
FILE ENTRY SPACE ALLOCATION 
PATMAN (EP1 of TSSD) determines the size of a new entry and obtains a 
pointer to the user's file list from the current UST. It is used by 
several file-derail processors, subsequent to a call to the file system 

MALC9 to access a nermanent file or obtain re Fila space. 


or 
PATMAN attempts to find sufficient space in the second area dedicated to 
user's PATs, and if successful, links the combined file entry passed by 
the caller into the user's threaded file list, and returns an offset to 
the PAT pointer. In some cases PATMAN is called following an extension 
of a temporary file to relink a previously freed entry (see FREE). It is 
also called during logging-on to initiate the user's file list with an 
SY** entry. 


tempora ak > 4 


PRECALLING SEQUENCE 


None 


CALLING SEQUENCE 


PATMAN is called from SYMAN, DRLFIL, TASK, FILACT and MORLNK via: 


8 16 
TSX1 IPATMAN 
Zero 'L(pate) ,0 


Error return--duplicate name 
Normal return 
I 


(pate--the combined AFT/PAT entry) 
OPERATING SYSTEM INTERACTION 
No 


-STEMP storage is used. 


No gates are used. 
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GECOS III SMD TSS EXECUTIVE 


PATMAN (EP 1) PATMAN (EP 1) 
TSSD TSSD 


ROUTINE RETURNS 


POSTCALLING SEQUENCE 
Error return: 


X5 = 0, no entry space available 
X5 #4 0, new file name duplicates the file pointed to 


Normal return: 


X5 = Offset to entry 
Count of open files in UST is updated 


SUPPORTING INFORMATION 


On allocation, PATMAN determines the size of the new entry, and obtains 
a pointer to the user's file list from the current UST. It compares’ the 
new file name with all files already in the list (if any), rejecting any 
duplicately-named new entry. Then PATMAN cycles through the 
available-space chain to find a space as large as, or larger than, the 
new entry. 


If the first such space found is larger than needed, the size field of 
the available-space chain word is adjusted accordingly and the word is 
moved to above the new entry space, entailing readjustment of the 
preceding chain word. If the space just fits, the preceding chain word 


is modified to point to the succeeding one, and the new entry is copied 
into the space so obtained. 


ee wea Jie OAL LIS s 


. 


The "old" end of the user's file list is found (if any), and the new 
entry is made the "new" end of the list, by manipulation of the 
respective forward and backward pointers, and the offset to the new 
entry is stored for return to the caller in X5. The PAT-pointer field, 
bits 4-17, of the first word of the file entry is set to point to the 
PAT body (always self-relative + 3), the user's open-file count is 
incremented, and return is made to the caller. 
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PATMAN (EP 1) PATMAN (EP 1) 


TSSD 


Programming Method 


PATMAN 1S nonreentrant and relocatable. 


Storage 


Internal temporary storage is used for saving registers and 
storage. 


Other Routines Used 


Let Slave Program Enter Master Mode FEMM (EP10 of .MFALT) 


TSSD 


working 
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PATDEA (EP2) PATDEA(EP2) 
TSSD TSSD 


FILE DEALLOCATION 


PATDEA (EP2 of TSSD) removes the file entry and releases the file space 
(temporary file) or deaccesses the file (permanent file), either for one 
specified file or for all of the user's open files (excepting Sy**). 
PATDEA is also called by TSSI to deallocate all of the user's files, 
again excepting SY**., 


PRECALLING SEQUENCE 


Prior to entering PATDEA, the registers listed must contain the data 
indicated. 


AQ File name in ASCII or 777 octal in AL if all files in user's 
AFT are to be deallocated 
X2 UST pointer 


CALLING SEQUENCE 


PATDEA is called from TSFIN, TERM and DRLRFL via: 


8 16 


TSX1 IPATDEA 

ZERO iCourtesy call, buffer 
Error return 

Normal return 

Courtesy jcall pending return 


OPERATING SYSTEM INTERACTION 
No .STEMP storage is used. 


No gates are used. 
ROUTINE RETURNS 


The error return is taken if the specified file is not found, or if no 
files are found. 
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PATDEA (EP2) PATDEA(EP2) 
TSSD TSSD 


The normal return is taken when PATDEA has _ successfully completed 
deallocation. The user's open-file count in the file-list pointer word 


tsa 


fod 
is decremented on return. 


The Courtesy Call Pending return is taken following the MME GEFSYE 
issued by PATDEA (for permanent files) and prior to the courtesy cail 
resulting therefrom. The courtesy call address is only pertinent when a 
permanent file is to be deallocated (because the file system is called 
to deaccess permanent files). 


The buffer must be a BSS of 380 words. It need only be given when a 
permanent file is to be deaccessed. It is required by the GECOS III file 
system. 


POSTCALLING SEQUENCE 


None. 


SUPPORTING INFORMATION 


If a temporary file, the necessary parameters are obtained, .MALC9 is 
called to deallocate the space, and the file entry is freed. If a 
permanent file, the offset to its entry is stored in a MME GEFSYE 
calling sequence. (The entry is not unlinked at this point.) Note that 
the entry for SY** is bypassed. If no entries exist, the error return is 
taken immediately. Otherwise, if "all-files" is specified, a loop is set 
up to cycle through the complete file list. 


When the file list is exhausted and permanent files exist, the MME 
GEFSYE call for deaccessing the file(s) is set up in the beginning of 
the buffer (buff), the Allocator is notified that the calling subsystem 
is doing I/O and is not to be swapped, and the MME GEFSYE is executed 
from buff. The immediate caller (generally DRL RETFIL) is then returned 
to via the courtesy call pending return, where control can relinquish to 
some other portion of the Executive, normally Line Service. When the 
courtesy call is honored, the still-linked file entries are freed and 
the normal return is taken. 


If one file has been specified, rather than all, the procedure outlined 
above is followed except that the file list is searched through once for 
the named file. If it is not found, the error return is taken. 
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PATDEA (EP2) PATDEA(EP2) 
TSSD TSSD 


Programming Method 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Let Slave Program Enter Master Mode FEMM (EP10 of .MFALT) 
Return LINKS/LLINKS to the Pool ONE (EP1 of .MALC9) 
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FREE (EP3) FREE (EP 3) 
TSSD TSSD 


DELINKING A FILE 


FREE (EP3 of TSSD) unlinks a file entry and makes that entry space 
available. 


PRECALLING SEQUENCE 


Prior to entering FREE, the registers listed must contain the data 
indicated. 


X2 UST address. 
X4 Absolute address of file entry. 


CALLING SEQUENCE 


Me) 


ad DPLPET 


} 4 
fo 


ae ibe ioe we Se 


EFPREP ics called from FILACT, TASK, TERM a 


8 16 


from PATDEA: 


XED \FREE,$ 
Return 


The call must be made in master mode. 


OPERATING SYSTEM INTERACTION 
No .STEMP storage is used. 


No gates are used. 
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FREE (EP3) FREE (EP 3) 
TSSD TSSD 


POSTCALLING SEQUENCE 


Open-file count in file list pointer word in UST is decremented. Space 
occupied by the entry is zeroed during unlinking process. 


SUPPORTING INFORMATION 


The entry is unlinked from the list by storing its back pointer into its 
successor's back pointer, and storing its forward pointer into its 
predecessor. 


The unlinked entry is zero-filled, its length being ascertained in the 
process. Then, if an available-space element exists below the zeroed 
space, the number of freed words are added to its count. not, the 
zeroed space is linked into the available space chain at starting 
point, i.e., is pointed to by the origin word. 


Lt 
its 
The user's file count is decremented prior to return to caller. 


Programming Method 
FREE is nonreentrant and relocatable. 


Interrupts are inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


None. 
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TSS EXIT (TSSE) 


The TSS Exit (TSSE) performs the wrapup procedures necessary when the 
time-sharing system is aborted. 


TSSE contains one entry point: 
e EPL TSS Wrapup (TSFIN) 


TSSE occupies approximately 130 (octal) core storage locations. 
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TSFIN(EP1) TSFIN(EP1) 
TSSE TSSE 


TIME-SHARING WRAPUP 


TSFIN (EPl of TSSE) deallocates all the TSS associated files in SSA1l and 
SSA2 when the time-sharing system is aborted. 


PRECALLING SEQUENCE 


At TSS startup time, octal location 27 contains the address of TSFIN. 


CALLING SEQUENCE 


Upon return from the call to LINSRV, entry is via 


TRA pRREUE 


OPERATING SYSTEM INTERACTION 
No .STEMP storage is used. 


No gates are used. 
ROUTINE RETURNS 
When processing is complete a MME GEFINI is executed thus terminating 


TSS execution. 


POSTCALLING SEQUENCE 


None. 
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TSFIN (EP1) TSFIN (EP1) 
TSSE TSSE 


SUPPORTING INFORMATION 


When the time-sharing system is aborted, GECOS III gives control to the 


address in location 27 (octal) as part of the abort procedure. MTSFIN 
sets the NONEW and ABORT bits in .TLFLG and then sends disconnects’ to 


seen q 


all active lines. The disconnects are then handled in the normal way by 
LINSRV, thus clearing up ail UST's and deaccessing (perm) or releasing 
(temp) any activie files. Control is then returned to TSFIN. TSFIN calls 
.MALC9 to release the collector file, calls GERELS to release the 
temporary TSS system files, and calls GEFSYE to deaccess the permanent 
TSS system files (if any exist). TSFIN then exits with a MME GEFINI. 
This gives control back to GECOS III, where the abort procedure will be 
completed. 


Programming Method 


TSFIN is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


MME GERELS Processor RELS (EP1 of .MRELS) 

MME GEROUT Processor GROUT (EP1 of .MROUT) 

End Courtesy Call ENCC (EP5 of .MDISP) 

Deaccess File FSINT1 (EP1 of .MFS04) 

Let Slave Program Enter Master Mode FEMM (FP10 of .MFALT) 
Terminate MME GEFINI Entry FINI (EP2 of .MBRT1) 

Line Service LINSRV (EP1 of TSSJ) 

Return LINKS/LLINKS to the Pool ONE (EP1 of .MALC9) 


wo 
wo 


GECOS III SMD TSS EXECUTIVE 


SYSTEM ERROR (TSSF) 


It contains one entry point: 


e EPIL System Error (ERROR) 


TSSF occupies approximately 330 (octal) core storage locations. 
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ERROR (EP 1) ERROR (EP1) 
TSSF TSSF 


SYSTEM ERROR 
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console. 


The message at the GE-600 is: 


*TSS AUTOMATIC ERROR RECOVERY XXXX 
At the user's terminal, it is: 


YOU HAVE BEEN TERMINATED 


TERMINATE CODE XXXX 


In both cases, XXXX is an error code from the table which follows. No 
messages are issued when TSS aborts (that is, no error recovery exists 
or recovery has been exhausted). If TSSF is entered via courtesy call, 
tie error 1s tabulated put tne user 1S not terminated and no snaps are 
taken. 


PRECALLING SEQUENCE 


Prior to entering ERROR, the registers listed must contain the data 
indicated. 


Q 4-character error code (9=-bit ASCII) 
X2 UST address 


CALLING SEQUENCE 


ERROR is called from LINSRV, EXENTR, ALLOC, ALL7AC, PNTERR and SWAP via: 


8 16 
TSX1 1 ERROR 
Return 
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ERROR (EP 1) ERROR(EP1) 
TSSF TSSF 


OPERATING SYSTEM INTERACTION 


No gates are used. 


ROUTINE RETURNS 


ERROR returns to the caller following a snap unless entered via courtesy 
call, in which case TSSF executes a MME GEENDC. 


POSTCALLING SEQUENCE 


None. 


SUPPORTING INFORMATION 


Five errors cause abort unless otherwise stated; SNAP occurs unless 
otherwise stated. 


CODE SOURCE MEANING RECOVERY ACTION 
OPFT EXEC ILLEGAL OP CODE ABORT ON 2nd OPFT 
MEMF EXEC Memory fault ABORT ON 2nd MEMF 
FCDF EXEC Fault code fault Normal 
DCFT EXEC Divide check fault ABORT on 3rd DCFT 
OVFF EXEC Overflow fault ABORT on 3rd OVFF 
760X STARTUP 760 Buffer lost Normal 
DRLF EXEC Derail fault Normal 
SYP? EXEC Lockup,ONC, Parity fault ABORT 

(user) 
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ERROR (EP1) 
TSSF 


ALLQ 


ALL7 


ALLP 


ALLC 
CUST 


(X1) CM 


Programming Method 


ALLOC 


LINSRV 


LINSRV 


PNTERR 


ALLOC 


ALLOCI 


ALLOCI 


ALLOCI 


ALLOCT 


CUST 


ALLOC 


Allocation queue error 


Error in UST scan 


Cannot terminate user I/O 


No room in new user 
table 


DATANET 30 BUSY Status 


Error while issuing 
error message 


Attempt to return 0 
swap space 


Duplicate UST pointer 
in core map 


Request to clear swap 
space location 0 


Illegal parameter to 


AL EOC 


Error in UST COLLECTION 


Incorrect core map 


ERROR iS nonreentrant and relocatable. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 
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ERROR (EP 1) 
TSSF 


Normal 


No disconnect, no user 
message 


ABORT on 2nd HANG 


No snap, no disconnect 
no user message 


No snap, no user message 


Normal 


ABORT 


ABORT on 3rd ALLO 


ABORT on 3rd ALL7 


ABORT 


ABORT on 2nd fault 
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ERROR(EP1) ERROR(EP1) 
TSSF TSSF 


Other Routines Used 


MME GEINOS Processor INOS (EP5 of MIOS) 

Let Slave Program Enter Master Mode FEMM (EP10 of .MFALT) 
Update Allocator Queue ALLOC (EP1 of TSSL) 

Terminate Error Entry FALT (EP3 of .MBRT1) 

Obtain Normal Snapshot GESNIP (EP1 of .MSNP1) 

Initiate Remote I/O KEYIO (EP2 of TSSI) 

MME GEROUT Processor GROUT (EP1 of .MROUT) 

End Courtesy Call ENCC (EP5 of .MDISP) 

Send "Stop Paper Tape" to DATANET PPTOFF (DRL STOPPT, TSSK) 
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EXECUTIVE ERROR MESSAGES (TSSG) 


The Executive Error Messages routine (TSSG) prints a preset 
message onto a remote device. 


It contains two entry points: 


e@ EPl Print Error Message (PNTERR) 
e EP2 Special Entry (PNTTSX) 


TSSG occupies approximately 1320 (octal) core storage locations. 


Message Text 


The messages printed by TSSG are as follows: 


a ‘ 
Conmuueit 
LOHR oD 


Number Text 

af 001 - Incorrect Primitive 

2 Bad File I/O Command 

3 003 - Bad DCW 

4 004 - Address Out of Range 

5 005 - Bad DRL Code 

6 006 - Level of Control Too Deep 
a 007 - Bad Program Descriptor 

8 008 - Loop In Primitives 

9 009 - System Unknown 

10 010 - Program Too Large To Swap 
11 011 - Incorrect Core File Usage 
12 012 - Program Not Allowed Use of This I/O 
13 013 - DRL Allowed Only by LOGON 
14 DRL RELMEN - Request Release of Too Much Core 
15 015 - Cannot Reset ID 

16 016 - Overflow Fault 

L7 017 - Illegal Op Code 

18 018 - Memory Fault 

19 019 - Fault Tag Fault 
20 020 - Divide Check Fault 
21 021 - Bad Status Swap Out #S 

22 022 - Bad Status Swap In #S 

23 023 - Bad Status Load #P 


error 
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024 
You 
You 
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- Bit Position > 35 
Have File Accessed Without Write Permission 
Have File Accessed Without Read Permission 


Address Is Outside of File Limits 


028 
029 
134 
135 
138 
139 
DRL 
DRL 
Not 


- Read Linked Files Only With This Command 

- Illegal System Selection 

- Invalid Function Number In DRL FILACT 

- User Cannot Access the System Master Catalog 
- TAP* File Undefined 

- Error in Writing TAP* File 

ABORT - File Not Saved 

ABORT - Program Dumped 

Enough Core to Run Job 


Sorry - Out of Swap Space. Try again. 
File Address Error - Retry 


DRL 
DRL 
Bad 


ABORT - Error on Program Dump 
ABORT - ABRT File Too Small for Entire Dump. 
Status - DRL SAVE/RESTOR File 


SAVE/RESTOR Filename Not in AFT 


064 


- Execute Time Limit Exceeded 


Illegal Break Vector 


065 


- Object Program Size Limit Exceeded 


Incorrect Entry to DRL TASK 
RESTOR Program Name Undefined 
Reached Catalog Limit on DRL SAVE 


DRL 
Bad 
DRL 


PSEUDO: Tally Incorrect 
DRL SAVE Data Location 
SAVE - Do First Program Save Before Added Prog. 


DRL SAVE On Random File Only 
Terminal Type Not Allowed DRL PSEUDO 
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PNTERR(EP1) PNTERR (EP1) 
TSSG TSSG 


PNTERR (EP1 of TSSG) prints a preset message onto a remote device and 
returns to LINSRV. 


PRECALLING SEQUENCE 


Prior to entering PNTERR, the X3 register must contain the error comment 
number. 


CALLING SEQUENCE 


PNTERR is called from DRLKON, DRLKOT, DRLDIO, TSXSPF, FILACT, CORFIL, 
USERID, CALLSS, DRLABT, RESTOR, EXENTR, ALLOC, ALL7AC, SWAP, SAVE, TASK, 
FAKEIN, SCAN1, SCAN2 and SCAN3 via: 


8 16 
f ! 
TSX1 IPNTERR 


Return to LINSRV 


For additional details, see PNTTSX. 
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PNTTSX (EP2) PNTTSX (EP2) 
TSSG TSSG 


SPECIAL ENTRY 


PNTTSX (EP2 of TSSG) prints a preset message onto a remote device and 
returns to the caller. 


PRECALLING SEQUENCE 


Prior to entering PNTTSX, the X3 register must contain the error comment 
number. 


CALLING SEQUENCE 


PNTTSX is called from the DRLABT, RESTOR, STARTP, SAVE, EXENTR- and 
ALL7AC via: 


| 
TSX1 IPNTTSX 
Return to caller 


OPERATING SYSTEM INTERACTION 
No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


PNTTSX returns to the calling routine. 


POSTCALLING SEQUENCE 


None. 
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PNTTSX (EP 2) PNTTS X (EP2) 
TSSG TSSG 


SUPPORTING INFORMATION 


The procedure involves the use of the pseudo-courtesy call for remote 
I/O in the user status table for this user. As each terminate is 
recognized by the Line Service module, the courtesy call is honored and 
the next portion of the operation started. There are four phases of 
operation possible: 


- I/O in progress 
Flush buffer 

- Print error message 
- Resume operation 


& WD F 
e 


If I/O is not in progress the first phase is skipped. If there is room 
in the buffer, the second and third operations may be combined. 


The first two entries in the text portion of the table are XED 
instructions. These are pointers to entry points for the third and 
fourth phases of the sequence. The courtesy call is then set to point to 
the proper XED after the keyboard I/O is initiated. The code for each 
phase obtains the location of the XED which defines the proper text 


message. The indicated action is taken and return is made to Line 
Service. 


On entry to the routine, the subsystem is taken out of Allocator's queue 
by a call to ALLOC with a kill code. When the last phase is complete, 
the process is resumed by asking the user to reselect a system. All 
files are preserved so the user may make corrections and resume his 
process. 


Programming Method 


PNTTSX is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 
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PNTTSX (EP2) PNTTSX (EP2) 
TSSG TSSG 


Other Routines Used 


Update Allocator Queue ALLOC (EP1 of TSSL) 

System Message Generator SYS (EP3 of TSSI) 

Buffer Dump BUFDMP (EP4 of TSSK) 

System Error ERROR (EP1 of TSSF) 

Transmit Data to Buffer STOBUF (EP6 of TSSK) 

Set Tally for Output Buffer STBTAL (EP7 of TSSK) 

Line Service LINSRV (EP1 of TSSJ) 

Send "Stop Paper Tape" to DATANET PPTOFF (DRL STOPPT, TSSK) 
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ovat tiesto! nr RU TAD NRnMANNnAAN.A Mmamry 

LUNLTRUL Ur UOnN FRU DoOvonko \ljivon) 

The Control of User Processes subprogram (TSSH) controls the sequence of 
events occurring when the user selects a subsystem or inputs a command 
language word. This sequence is dependent on the subsystem or command 
Tanniana wead 

bayuayr Wn we 


This organization avoids the definition of one global set of command 
language for all subsystems and provides a reasonably flexible and 
powerful capability for defining logical sequences of actions at _ the 
time a subsystem is entered into the system. A time-sharing system in 
which the command language and the associated responses are defined 
within the executive would make it difficult to incorporate new 
subsystems into the time-sharing system with new command language words 
and associated actions. 


Each subsystem in the time-sharing system includes a program descriptor. 
A part of this program descriptor can be a list of command language to 
be recognized while the subsystem is active. Each of these defined 
command words has an associated list of primitives defining a sequence 
of actions to be performed by TSS. The primitives are high-level control 
functions which can call other subsystem programs, initiate an input 
stream from the remote terminal, etc. In addition to the sets of 
primLtives associatea with eacn commana WOLQa, tnere 1S a set OL otTartup 
primitives used for initial entry into the subsystem. In many cases, it 
is desirable to go through preliminary functions, such as an edit, 
before actually entering the selected subsystem program. 


In this framework, each subsystem program is considered to be a 
self-contained element of the total process in that TSSH selects and 
loads the program (EXEC primitive) and the program returns to TSSH, 
which selects the next primitive and continues its flow of logic from 
that point. One of the primitives returns to the build mode in order to 
resume input from the keyboard and scan for more command language, 
providing a large amount of flexibility and control of the logical flow 
by the user. 


TSSH uses the User Status Table associated with each user and the 
program descriptor tables to direct the flow for a given user. Pointers 
to the program descriptor area and the current primitive are kept in a 
list in the UST. Since it is possible to have several levels of control, 
this is a pushdown list (called program stack) with the last entry 
having the active pointers. 


The program descriptor contains the command language and associated 
primitives for a given program. Included in the program descriptor is a 
startup sequence to be executed when the program is initially selected 
or called. 
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The following diagram shows the relationships between the pointers in 
the program stack and the program descriptors and primitives. 


Program 
Descriptor 
A 
Program Stack 
(in UST) 
Command 
Words and 
B CALL Primitives 
TALLY of A 
L(A) L(PA) 
L(B) L(PB) 
Program 
Descriptor 
B 
Command 
Words and 
Primitives 
of B 
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EPL Scan for Control Language (SCAN1) 
EP2 Scan for Known Command Word (SCAN2) 
EP3 Interpret Primitive (SCAN3) 


SCAN1 and SCAN2 are used by Line Service to perform the scan for. and 
initiation of processes based on command language. SCAN3 is used by 
STARTP and the Derail Processor to initiate execution of the log-on and 
log-off subsystems and to interpret the RETURN primitive. 


TSSH occupies approximately 470 (octal) core storage locations. 


Summary of Primitive Actions 


CALLP a (where a is program descriptor location) 


CALLP transfers control to the subsystem program descriptor 
located at a. ‘SSH finds the startup sequence rrom tne program 
descriptor and takes its next primitive from this list. CALLP 
may occur in any list of primitives of a program descriptor and 
interrupts the execution of primitives from the present list. 
However, it is normally necessary for TSSH to return to that 
level after a series of functions performed by the called 
program are complete. The location of the primitive when the 
CALLP was encountered is saved in a pushdown list associated 
with the user status table. Thus, it is possible to have several 
levels of calls and to be able to resume operation at a previous 
level. (The primitive POPUP will resume operations at the 
previous level.) 


EXEC 


EXEC initiates loading and execution of the current subsystem 
program. This is accomplished by placing the job in the new 
interaction queue for Allocator by calling ALLOC with a code of 
1. When the subsystem program has completed its functions, it 
returns to Executive via a derail operation and the next 
primitive in the sequence will be executed. 
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BIN 


BIN initiates the build mode of terminal input. While in this 
mode, Line Service reads and accumulates data on a collection 
file (SY**) for this user. Each line of input is scanned for the 
command language associated with this subsystem program. This 
scan is done by SCAN1, which is called by Line Service each time 
a line is read from the remote keyboard. If no command language 
is found, Line Service accumulates the input in buffer and dumps 
it when required to the user's collector file. If a command word 
is recognized, SCAN1 notifies Line Service which does’ the 
necessary housekeeping before the command is executed. A 
subsequent call to SCAN2 starts execution of the referenced 
primitives. Note that once the build input primitive is 
encountered, there is no "next" primitive implied. The next 
primitive is defined when a command word is encountered. 


POPUP 


POPUP indicates that processing at this level is complete and 
processing at the previous level is to be resumed. SCAN3 reduces 
the tally, obtains the previous set of pointers from the User 
Status Table, obtains the next primitive and continues the flow 
of control from that point. However, if the subsystem was 
invoked by a DRL CALLSS from the previous subsystem, the caller 
of the subsystem is restored to the Allocator queue and the 
control goes to the Line Service. If the previous level does not 
exist (that is, this was the first level of control), POPUP 
calls the system routine which will ask the user which subsystem 
program he wishes to select next. All files defined during 
previous calls will remain defined. 


RETURN 


RETURN advances the primitive pointer by one and resumes 
execution of primitives. It is not a true primitive in that it 
is not entered into the primitive list in program descriptors, 
but will be executed when a subsystem does a DRL RETURN to the 
Executive. The Derail processor enters SCAN3 which executes’ the 
RETURN primitive and resumes the execution at the next 
primitive. 
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IFALSE n,e a 


LSE provides for conditional execution of biocks of primitive 
ators. The conditional test is based on the user switch word 
TH) in the User Status Table. The interpretation is, "If 
n false (off), tra r control to the block of 

at location a." If test is true (on), control 
passes to the next primitive in sequence. This function allows 
considerable interaction between the execution of subsystem 
programs and the interpretation of primitives. A subsystem can 


also (via the specified derail) set or reset these switches. 


itive Ne WL LNA 


IFTRUE n,e a 


Interpretation of IFTRUE is the same as IFALSE, except that 
transfer of control passes to a if bit n of .LSWTH is true (on). 


STRUE n,a 


STRUE provides the capability of setting bits ON in the switch 
word (.LOW'LH) an the aindividuai User status tabie, ror 
subsequent testing by IFALSE and IFTRUE. The setting and testing 
of these bits allows considerable interaction between subsystem 
programs, Since they can pass information to each other by means 
of the switch word. Subsequent subsystem programs can _ then 
execute different blocks of code, based on the settings made by 
previous primitives, which could be different for different 
sequences of primitives. The interpretation of the above 
primitive is, "Set bit n true (ON) in the current User Status 
Table, and transfer control to the block of primitives starting 
at location a." 


STFALS n,a 


The interpretation of STFALS is the same as STRUE, except that 
bit n is set false (OFF). 
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SCAN1 (EP1) SCAN1(EP1) 
TSSH TSSH 


SCAN FOR CONTROL LANGUAGE 


SCAN1 (EP1 of TSSH) searches for command language but takes no further 
action. (See SCAN3 for example.) 


PRECALLING SEQUENCE 


Prior to entering SCAN1, the registers listed must contain the data 
indicated. 


X2 UST address 
X3 Address of (possible) command word 


CALLING SEQUENCE 


SCAN1L is called from STG1O via: 


8 16 
| 
TSX1L jSCAN1 
Return |(Control language found) 


Return {(Control language not found) 
] 


OPERATING SYSTEM INTERACTION 
No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


SCAN1 returns to the calling routine. 


POSTCALLING SEQUENCE 


X3 is not saved 
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SCAN1 (EP1) 
TSSH 


SUPPORTING INFORMATION 


See SCAN3 


Programming Method 
SCAN1 is reentrant and relocatable. 


Interrupts are inhibited while scanning. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Trace Recent Events TSEVNT (EPi of TSSB) 


GECOS III SMD 


TSS EXECUTIVE 


SCAN1(EP1) 
TSSH 
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SCAN2 (EP2) SCAN2 (EP2) 
TSSH TSSH 


SCAN FOR KNOWN COMMAND WORD 


SCAN2 (EP2 of TSSH) initiates action based on the command language word 
found, then falls through to SCAN3. (See SCAN3 for example.) 


PRECALLING SEQUENCE 


Prior to entering SCAN2, the registers listed must contain the data 
indicated. 


X2 UST address 
X3 Address of command word 


CALLING SEQUENCE 


SCAN2 is called from STG10 via: 


8 16 


I 
TSX1 ISCAN 2 
Error return 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


If command word found, falls through to SCAN3; otherwise, error return. 


POSTCALLING SEQUENCE 


A contains primitive to be interpreted. 
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SCAN2 (EP2) SCAN2 (EP2) 
TSSH TSSH 


SUPPORTING INFORMATION 


See SCAN3. 


Programming Liethod 
SCAN2 is nonreentrant and relocatable. 


Interrupts are inhibited while scanning. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


None. 
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SCAN 3 (EP 3) 
TSSH 


INTERPRET PRIMITIVE 


SCAN3 (EP3 of TSSH) initiates execution of 


subsystems and interprets the RETURN primitive. 


PRECALLING SEQUENCE 


Prior to entering SCAN3, the registers listed 
indicated. 


X2 UST address 
A Primitive to be interpreted 
X0 Present primitive 


CALLING SEQUENCE 


SCAN3 is called from STARTP and DRLRET via: 


TSX1 ISCAN3 
Return I 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


ROUTINE RETURNS 


SCAN3 returns to the calling routine. 
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SCAN 3 (EP3) 


log-on and 


contain 


TSSH 


log-off 


the 


data 


SCAN 3 (EP3) 
TSSH 


POSTCALLING SEQUENCE 


None. 


Example of Flow 


As an example of the flow th 
descriptors for subsystems 
defined--LIST and EDIT. The 
normal sequence of inputting 
follows: 


GECOS III SMD TSS EXECUTIVE 


SCAN3 (EP3) 

TSSH 

rough TSSH, a simplified set of program 
associated with the BASIC compiler is 


actions generated when a user goes through a 
and running a new program will be as 


Program Descriptor for BASIC 


Command Language for BASIC 


List 


CALLP EDIT 
CALLP LIST 
BIN 


} 


} 


RUN 
CALLP EDIT 
EXEC 
BIN 
DONE 
POPUP 


(Startup) 


} 


Program Descriptor for EDIT 


BIN 


Command Language for EDIT 


(None) 
(Startup) 


EXEC 
POPUP 


Command Wor 


Language 


Primitives for LIST 


Command Language Word 


Primitives for RUN 


Command Language Word 
Primitive for DONE 


Primitive to be executed to 
initiate BASIC when called 
from other primitive or EXEC 


No Command Language 


Startup Procedure for EDIT 
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SCAN 3 (EP 3) SCAN3 (EP 3) 
TSSH TSSH 


Program Descriptor For LIST 


Command Language for LIST 


(None) No Command LANGUAGE 
(Startup) 

EXEC Startup Procedure for LIST 
POPUP 


User Actions 


A sequence of user actions at the terminal is now defined. 


Re 
e 


Dial up, reply to log-on sequence, and then the time-sharing 
system requests SYSTEM ? . Response is BASIC. 


2. The user types in a series of BASIC statements (not necessarily 
in order). 


3. The user types in LIST. 


4. The user types more statements. 


5. The user types RUN. 


6. The user types DONE. 


At step 1, Line Service takes the results of the SYSTEM question and 
initiates execution by calling a control routine, STARTP. This simulates 


a CALLP BASIC primitive which then sets up the first level pointers in 


the User Status Table and proceeds to execute the startup sequence for 
BASIC. 


This primitive is the BIN and will cause SCAN3 to set the proper flags 
and ask Line Service to initiate the accumulation of input data. The 
user now enters step 2 and types in source statements for BASIC. These 
are accumulated by Line Service into a file (SY**) for this user. The 
user enters step 3 by typing the command word LIST. LIST is detected by 
SCAN] (via a call from Line Service). After Line Service flushes its 
buffers, SCAN2 starts execution of the sequence of primitives associated 
with LIST. The primitive pointer is set to the first primitive which is 
retrieved and executed. This is a CALLP EDIT and is required to sort the 
file before listing the output. 
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SCAN 3 (EP3) SCAN 3 (EP3) 
TSSH TSSH 


A new entry is made in the program stack in this User Status Table and 


ee ale Tete ates ~~ es eae mn 


the program descriptor entry for EDIT is found. The startup procedure 
for EDIT is then found and the current primitive pointer set to this 


tar oer 


location. The primitive is retrieved and interpreted as EXEC. 


nn 


When EDIT has comnleted its task, TH urd 


1 nn 
a 2 ee re wean dod weuAne he Weis ro 


SCAN3 will request that Allocator load and execu 

1 erform e 
entry in Executive and SCAN2 will obtain its next pri ve using the 
entry in the program stack at the previous level. This is CALLP LIST. 
Therefore, when the LIST program descriptor is found, a new entry is 
made in the program stack, and the same procedure as was performed for 
EDIT is again performed. That is, LIST is executed and the POPUP 
performed to return control at the previous level. The primitive here is 


now BIN. Input is initiated as before. 


The user is now at step 4 in the sequence; the new input is being 
accumulated on his scratch file by Line Service, as before. At step 5, 
the user types the command word RUN. SCAN1 finds a command and then 
SCAN2 will find the associated string of primitives (both called by LS). 


The sequence will be the same as before. A new entry is made in the 
program stack and the startup sequence is found and initiated. When the 
EDIT program returns, the POPUP primitive is encountered returning 
control to the next primitive in the RUN sequence (EXEC). SCAN3 makes 
this ceyuest Of AtiocatuL. when BAdSiC 1S ioadea and in execution, BASIC 
compiles the source file data (now properly edited) and gives control to 
the compiled program. Eventually, it returns and SCAN2 finds the next 
primitive, BIN. The user can now make more corrections and repeat’ the 
sequence as often as is desired. When he is finished with BASIC, the 
user types DONE. This is a command language word and will be interpreted 
by SCAN2. This says POPUP, but there is no previous level, so SCAN3 asks 
Line Service to initiate the SYSTEM ? sequence and wait for the user to 
ask for another system. The user could, at this point, sign off or 
select some other system. 


This example has been considerably simplified to facilitate the 
description of the flow. For example, no provision was made for using an 
old file or saving the source file, or for testing and setting switch 
word bits. Extensions to the command language make this possible. 


See the more detailed example of flow in the programmer's’ reference 
manual, CPB-1514, 


Programming Method 


SCAN3 iS nonreentrant and relocatable. 


Interrupts are not inhibited. 
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SCAN 3 (EP3) SCAN 3 (EP3) 
TSSH TSSH 
Storage 


No internal temporary storage is used. 


Other Routines Used 


Update Allocator Queue ALLOC (EP1 of TSSL) 
System Message Generator SYS (EP3 of TSSI) 
Print Error Message PNTERR (EP1 of TSSG) 
TSS Subsystem Startup STARTP (EP4 of TSSI) 
Trace Recent Events TSEVNT (EP1 of TSSB) 
UST Collect CUST (EP2 of TSSN) 
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UTILITY ROUTINES (TSSI) 


+ 
= 


Routines (TSSI) perform the startup, termination 


The Utility 
procedures required by TSS. 


i 
accounting 


EP1 Terminate Routine (TERM) 

EP2 Clear UST and Make Accounting Entry (TRMCU) 
Initiate Remote I/O (KEYIO) 

EP4 System Message Generator (SYS) 

EP5 TSS Subsystem Startup (STARTP) 

EP6 Input Collector File Space Manager (SYMAN) 


@®eseeee 
tJ 
ae) 
WwW 


TSSI occupies approximately 730 (octal) core storage locations. 


a 


Has} 
Qu 
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TERM (EP1) TERM (EP1) 
TSSI TSSI 


TERMINATE ROUTINE 


TERM (EP1 of TSSI) clears the user's open-file list (releases temporary 
files and deaccesses permanent files). 


PRECALLING SEQUENCE 


Prior to entering TERM, the registers listed must contain the data 
indicated. 


X2 UST address 


CALLING SEQUENCE 


TERM is called from TERMPG and NEWUSER via: 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Returns to LINSRV to pass on to next active UST. 


POSTCALLING SEQUENCE 


None. 
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TERM (EP1) TERM (EP1) 
TSSI TSSI 


SUPPORTING INFORMATION 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Trace Recent Events TSEVNT (EP1 of TSSB) 

File Deallocation PATDEA (EP2 of TSSD) 

Line Service LINSRV (EP1 of TSSJ) 

Let Slave Proyram Enter iiaster Mode FEMM (EPiU or .MFALT) 
Delinking a File FREE (EP3 of TSSD) 

Update Allocator Queue ALLOC (EP1 of TSSL) 


End Courtesy Call ENCC (EP5 of .MDISP) 
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TRMCU (EP2) 
TSSL 


CLEAR UST AND MAKE ACCOUNTING ENTRY 


TRMCU (EP2 of TSSI) constructs and writes a record on the 
file, then clears and initializes the UST for the next user. 


PRECALLING SEQUENCE 


Prior to entering TRMCU, the registers listed must contain 
indicated. 


X2 UST address 


CALLING SEQUENCE 


TRMCU is called from TERMPG and NEWUSER via: 


TSX4 TRMCU 
Return | 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used, 


ROUTINE RETURNS 


TRMCU returns to the calling routine. 


POSTCALLING SEQUENCE 


None. 
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TRMCU (EP2) 


TSSI 


accounting 


the data 


GECOS III SMD 


TRMCU (EP 2) 
TSSI 


SUPPORTING INFORMATION 


Interrupts are inhibited throughout. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Trace Recent Events TSEVNT (EP1 of TSSB) 

Update Allocator Queue ALLOC (EP1 of TSSL) 

Let Slave Program Enter Master Mode FEMM (EP10 of .MFALT) 
Accounting Fiie kKequest ACTFL (BPijS Or .MiUsS) 

MME GEINOS Processor INOS (EP5 of .MIOS) 


TSS EXECUTIVE 


TRMCU (EP2) 
TSSI 
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KEYIO(EP3) KEYIO(EP3) 
TSSI TSSI 


INITIATE REMOTE I/0 


KEYIO (EP3 of TSSI) initiates keyboard I/O for a particular user, 
Depending upon the contents of the A-register, a MME GEROUT output, 
output-then-input, or prepare for paper tape input will be issued by 
KEYIO. Upon calling KEYIO, the following requirements are assumed 
fulfilled: 


1. The user is not presently engaged in remote I/O processing. 
2. The direct build mode flag is correctly set for this user. 


3. The current line pointer in the user's line buffer is pointing 
to the output message. 


4. All message data is in the correct format within the user's 
line buffer (that is, word count, character count, input buffer 
address, etc.). 


PRECALLING SEQUENCE 


Prior to entering KEYIO, the registers listed must contain the data 
indicated. 


X2 UST address 
A =0, output requested 
=1, output/input requested 
=-l, prepare for paper tape input 


CALLING SEQUENCE 


KEYIO is called from ERROR and BUFDMP via: 


8 16 

| 
TSX1 IKEYIO 
Return ! 

| 
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TSSI 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Normal return is to calling module. 


POSTCALLING SEQUENCE 


None. 
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Programming Method 


KEYIO is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Trace Recent Events TSEVNT (EP1 of TSSB) 
Monitor Procedures MONCK (EP2 of TSSJ) 


GECOS III SMD 


Conditional MME GEROUT Entry FGROUT (EP16 of .MFALT) 


MME GEROUT Processor GROUT (EP1 of 


TSS EXECUTIVE 


KEYIO(EP3) 
TSSI 
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SYSTEM MESSAGE GENERATOR 


SYS (EP4 of TSSI) generates the terminal message, SYSTEM?. 


PRECALLING SEQUENCE 


Prior to entering SYS, the registers 
indicated. 
X2 UST address 


CALLING SEQUENCE 


SYS is called from SCAN3, GOOD1O, STGIO, 


| 
TSX1 iSYS 
Return 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Returns to calling module. 


POSTCALLING SEQUENCE 


None. 
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SYS (EP4) 
TSSI 
listed must contain the data 


SYSRET, and NEWUSER via: 
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SYS (EP4) SYS (EP 4) 
TSSI TSSI 


SUPPORTING INFORMATION 


SYS initializes the user's buffer area and the program-stack tally word. 
A pseudo-courtesy call is inserted in the User Status Table, and _ the 
remote I/O flag and the CC-REQ'D flag are turned on. The combination of 
these two flags will result in Line Service executing the courtesy cali 
when the terminate from the output is received. The message SYSTEM? is 
inserted in the buffer and the message sent to the terminal via GEROUT. 
The status return from the MME GEROUT is located in the user Status 
Table for this user. 


When the pseudo-courtesy call is honored at the termination of the 
response from the user, the routine calls STARTP, to initiate operation 
of the system. 


Programming Method 


SYS is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Trace Recent Events TSEVNT (EP1 of TSSB) 
Line Service LINSRV (EP1l of TSSJ) 

Monitor Procedures MONCK (EP2 of TSSJ) 

MME GEROUT Processor GROUT (EP1l of .MROUT) 
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STARTP (EP5) STARTP (EP5) 
TSSI TSSI 


TSS SUBSYSTEM STARTUP 


STARTP (EP5 of TSSI) initiates the allocation of and dispatching to the 
requested subsystem. 


PRECALLING SEQUENCE 


Prior to entering STARTP, the registers listed must contain the data 
indicated. 


X3 Pointer to ASCII name of subsystem 
X2 UST address 


CALLING SEQUENCE 


STARTP is called from SCAN3, GOOD10, STGIO, CALLSS and NEWUSER via: 


8 16 


! 
ISTARTP 
Return | (Program initiated) 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Returns to calling routine. 


POSTCALLING SEQUENCE 


None. 
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STARTP (EP5) STARTP (EP5) 
TSSI TSSI 


SUPPORTING INFORMATION 


STARTP obtains the word specified by X3 and scans for a carriage return 
or end of word. The result is a name left-justified and blank-filled. 
Using this name, the list of program descriptors is searched for an 
identical name. If a match is found, a CALLP primitive is constructed in 
the accumulator and an entry made to SCAN3. The routine then returns’ to 


If the name is not found in the program descriptor list, control passes 
to the error printout routine PNTTSX which prints the message SYSTEM 
UNKNOWN and asks the user to reselect a subsystem. 


Programming Method 
STARTP is nonreentrant and relocatable, 


Interrupts are not inhibited. 


olLLaye 


No internal temporary storage is used. 


Other Routines Used 


Interpret Primitive SCAN3 (EP3 of TSSH) 
Special Entry PNTTSX (EP2 of TSSG) 
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SYMAN (EP6) SYMAN (EP6) 
TSSI TSSI 


INPUT COLLECTOR FILE SPACE MANAGER 


SYMAN (EP6 of TSSI) allocates and deallocates input collector files 
(SY**) in increments of -320-word blocks out of the file space acquired 
by TSTART. 


PRECALLING SEQUENCE 


Prior to entering SYMAN, the registers listed must contain the data 
indicated. 


2 UST address 
0, Allocate an SY** for the UST 
0, Deallocate an SY** for the UST 


CALLING SEQUENCE 


SYMAN is called from DYUST, RUST and NEWU76 via: 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Returns to calling routine. 


POSTCALLING SEQUENCE 


None. 
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SYMAN (EP6) SYMAN (EP6) 
TSSI TSSI 


SUPPORTING INFORMATION 


This routine uses a table, .TFBLK, set by Startup (TSTART). The table 
contains enough link descriptions to provide an SY** for each user. The 
links are pa artitioned into blocks and the PAT built on allocation. A bit 
in .TFBLK is set to mark the block used. An indication of the link an 

block used is kept in the PAT pointer. PATMAN is called to place the 
SY** file in the available File Table. 


On deallocation, the PAT is released and the bit in -TFBLK reset to 
indicate that the block is again available. 


Programming Method 
SYMAN is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Delinking a File FREE (EP3 of TSSD) 
File Entry Space Allocation PATMAN (EP1 of TSSD) 
Let Slave Program Enter Master Mode FEMM (EP10 of .MFALT) 
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LINE SERVICE (TSSJ) 


Line Service (TSSJ) provides the interface between the time-sharing 


system and the remote terminal system (GERTS) portion of GECOS III. (A 
remote-terminal connection with TSS is handled by GERTS in essentially 
the same manner as for any other slave program.) The line-service 
interface performs -- or is involved in -- the following functions 


l. Entering new users into the time-sharing system. 

2. Processing all remote I/O terminations. 

3. Accumulating build-mode input for each user. 

4. Enabling build-mode command-language scanning and prccessing. 
5. Periodic status reports to the main system console. 


Line Service initiates most remote, or keyboard, I/O except direct-mode, 
subsystem-requested I/O (via DRL's KOUT, KOUTN, and TAPEIN) and handles 


all remote-I/O terminations. Build-mode remote I/O, and the file I/9 


associated with it, is initiated exclusively within Line Service. 


Line Service is divided into several main portions, corresponding to the 
functions listed above. The passage of processor control through the 
different portions of the program corresponding to (1) and (2) is 
time-dependent; that is, each section gains control only if the duration 
of time since its last execution exceeds a specified interval, t, where 
the interval chosen is directly related to the priority of the function 
and the time required for its execution. (The time intervals will be 
periodically redefined, if required, as dictated by performance studies 


to provide the most efficient system flow.) Processor time spent in 
build-mode processing (3 and 4, above) is primarily controlled by MME 
GEROUT courtesy calls. (Initiation of build-mode for each user is 


enabled by TSSH, via flag settings for Line Service.) 


TSSJ contains two entry points: 


e EPL Line Service (LINSRV) 
e EP2 Monitor Procedures (MONCK) 


TSSJ also contains five return points from TSSJ extensions in TSSO. 


System Loaded-Reject New User (LDED) 

Enter new User in UST and Update NUQ Loop (GOOD10) 
Update to Next Entry (UPDAT) 

Build Mode Processing of Input (STGIO) 

Paper Tape Courtesy Call (PPTCC1) 


TSSJ occupies approximately 2530 (octal) core storage locations. 
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Entering New Users Into Time~Sharing 


Following time- ~Sharing startup, Line Service issues a MME GEROUT (remote 
inquiry) with the program name "GE-TSS." The location of this MME and 
the program name remains in GECOS III direct-access queue until a 
keyboard user requests a direct-access connection to this program, At 
this time, GECOS Tit inserts the user's 2-character station 
identification into the MME sequence and deletes this entry from its 


queue. 


Periodically, Line Service examines this MME for a nonzero station-ID 
field. When such a condition is encountered, Line Service places this 
station ID in TSS's new user queue and immediately reinitiates the 
reinitialized MME GEROUT, so that a remote inquiry is outstanding at all 


+4 mes. 
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It is possible that more than one user has requested connection to the 
time-sharing system in the time interval it takes Line Service to 
process the new station ID and initiate another MME GEROUT. Therefore, 
Line Service cycles this MME until a zero station ID is present, queuing 
the new ID's in the new user queue. 
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bervice processes the entries in the new user queue. Assuming that the 
time-sharing system is capable of handling m users simultaneously, Line 
Service tests the number of users presently on the system. If the system 
is loaded, LDED issues a system busy or loaded message to the 
prospective user, automatically disconnects the line, and deletes the 
entry from the new user queue. If the system is capable of accommodating 
another user, Line Service increments the count of users on the system 
and enters the station ID in the first available User Status Table (or 
calls DYUST). GOOD10 initializes accounting and statistics for the user, 
and enables the log-on sequence for this user via a TSX1 STARTP to call 
the NEW subsystem. Subsequently, SYS is called. 


When no users are present on the time-sharing system, Line Service sets 
an alarm clock and zero urgency. This allows time-sharing to be swapped 
out. When a terminal user requests the time-sharing system, GECOS III 
swaps time-sharing in, enters the user identification into the 
outstanding remote~inquiry entry, and enables the time-sharing system. 


Processing Keyboard I/O Terminations 


The main portion of Line Service processes keyboard termination for both 
completed input and output requests. This section of Line Service is 
processed every n milliseconds. 
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The amount of time spent in terminate processing is dependent upon the 
number of terminates, the number of buffer dumps to the disc/drum, and 
the normal/abnormal I/O terminate processing. 


Line Service begins terminate scanning at the first UST entry. To be 
eligible for Line-Service processing, the entry must satisfy the 
following tests: 


1. Remote-I/O-in-process bit is on. 


2. GEROUT has placed a nonzero keyboard-I/O status (or the 
executive, a minus 1) in the entry's remote status word, 
~LTTYS. 


(If the I/O status word is a minus one, Line Service assumes this to be 
the termination of some operation (é.g., line-buffer-flushing fil 
implying a continuation of build-mode for that user.) 


If the entry is eligible for terminate processing, Line Service examines 
the I/O completed status for abnormalities, in which case Line Service 
enables a recovery routine or indicates, in the UST, that I/0 
transmission was abnormal. 


If the keyboard I/O terminated with a normal status, Line Service 
determines if an all-points bulletin (APB) is to be sent to this user 
and, if so, outputs the message from the .TCCMT location in the 
time-sharing system's Communication Region. All flags are saved so that 
upon completion of the APB, control will be passed as it would have been 
before it was issued. Line Service then resets the remote I/O in process 
bit and then tests for CC REQD bit on. If the CC REQD bit was on, Line 
Service enables the required processing by turning off the CC REQD bit 
and transferring control to the entry's courtesy call word, which was 
preset by some portion of the executive (possibly Line Service itself). 
Upon return from the pseudo-courtesy call, Line Service tests whether 
the terminate cycle was completed. If not, it proceeds to the next 
active User Status Table via UPDAT. 


wD ee 


This procedure for passing control to a block of code at terminate time 
via the CC REQD bit is analogous to the true courtesy call for GECOS III 
I/O. The pseudo-courtesy call feature is used throughout’ the 
time-sharing system executive to initiate remote I/O and gain control at 
terminate time for updating status, initiating other processes, etc. The 
necessary procedure is: 


1. Set a transfer in user's courtesy call address, .LCC, to the 
block of code to be executed on a remote terminate (normally 
TSX3 --). 
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2. Set remote-I/O flag on and set CC REQD bit on. 
3. Initiate I/O. 


When the terminate status is found and the CC REQD bit is also on, Line 
Service does a TSX1 to the user's courtesy call entrance via .LCC. When 
the required function is completed, a return to the next Line Service 


instruction is expected (that is, TRA 0,1). 


If the CC REQD bit was not set (and assuming non-build-mode I/0), Line 
Service has completed all necessary terminate processing (that is, reset 
the remote I/O in process bit for the entry), and returns to the next 
UST entry or exits. 


The terminate processing performed cyclicly every n milliseconds 
primarily handles direct-mode (i.e., subsystem-initiated) and 
system-level I/O, plus abnormal build-mode termination processing and 
some returns from file I/O issued by Line Service. The bulk of 
build-mode terminate processing (described below) is performed within 
MME GEROUT courtesy calls, in order to speed up this function, but both 
modes of terminate processing are performed by the same code, virtually 
all of which is common to both. 


Direct-mode and executive-initiated remote I/O is issued without a 
(true) courtesy call. 


Accumulating Build Mode Input 


Upon receipt of a MME GEROUT courtesy call, the status word (.LTTYS) is 
checked for abnormal status (break, disconnect, etc.) and if so, the 
courtesy call is ended, with the remote-I1/O-in-process bit left on to 
allow this status to be dealt with during the next cyclic terminate 
processing. 


If the status was normal, the CC entrance bit is set. If the user is in 
auto mode and the current line pointer (.LSTEM+1) does not exceed the 
bounds of the line buffer threshold value, then either STGIO issues a 
line feed message and a new line number or changes the user to normal 
mode (i.e., not auto mode) and issues a line feed message and asterisk. 
Which action is taken depends on whether or not the user entered more 
than a CR (carriage return) in the previous line. If only a CR was 
issued, the second action is taken. If the user is not in auto mode or 
if the current line pointer exceeds the bounds of the line buffer, then 
STGIO does a TSX1 to SCAN] in TSSH to determine whether or not the last 
line contained a command (previous line pointer in .LSCLP,2). If the 
return from SCAN] indicates no command language in the input line, the 
current line pointer value for the user's line buffer is tested. 
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If the current line pointer exceeds the bounds of the line-buffer 
threshold value, appropriate flags are set and the courtesy call ended. 
On the next cycle, Line Service locates the user's collector file from 
his file table, and issues a MME GEINOS, with a courtesy call, to write 
the loaded buffer onto the disc. A TSX3 RTNCM is inserted in the .LCC 
location of the user's UST, and the MME courtesy call address is 
modified to point to the indicate that the file I/O was initiated and 
its termination must be handled by Line Service. Upon file termination, 
the courtesy call directs control to the user's .LCC location and 
executes the TSX3 RTNCM (the contents of XR3 indicate which UST is being 
processed). RTNCM, in Line Service, interrogates the file terminate 
status, and if normal, updates the current line pointer to the top of 
the line buffer. It resets the line buffer and sets the I/O status word 
to minus one with the remote-I/O-flag on (to indicate Line Service 
should continue build-mode input during the next processing cycle) and 
ends the courtesy call. 


If the current line pointer was within bounds, a line-feed and asterisk 
message is sent to the user during the original GEROUT courtesy call, to 
allow the input of an additional line from his terminal. 


In the event that an abnormal status is cCetected at the end of a MME 
GEROUT courtesy call, TSSJ tests that status to determine which of three 
possible situations exist - a remote disconnect, a BREAK received from 
the remote terminal, or a GBUSY, which indicates a timing error internal 
to the communications subsystem, in which a previous function did not 
properly terminate before the next function started. 


If the abnormal status is a GBUSY, control is transferred to ERROR (EPL 
of TSSF). Control then passes to UPDAT in TSSJ, which processes the next 
user. 


If the disconnect code is received, TSSJ checks with MONCK to determine 
if monitoring is in progress, and whether or not it is the master or 
monitored user who is disconnecting. If any of these conditions are 
true, monitoring is discontinued and the user in question is’ singled 
out. Termination then continues normally, with a call to ALLOC (EP1 of 
TSSL) with a code 1 to inform the allocator of the disconnect. Following 
Wrapup accounting, TSSJ calls STARTP (EP5 of TSSI) and when TSSI 
returns, control is passed to UPDAT. 


If the code received indicates a "BREAK", TSSJ checks to see if the user 
is already terminating, and if so, ignores the code and returns’ to 
UPDAT. If not, checks for monitored and/or master users, or 760 
terminals are made, and preliminary exception processing is done _ for 
them. Eventually, all I/O is reset, and a check is made to determine 
whether or not the user currently has a subsystem allocated. 
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If no subsystem is in use, TSSJ either pops up to the next primitive or 
ae cerca - 


returns to SYSTEM level, depending upon the condition of the user's 
stack, and exits to UPDAT. 


If a subsystem is in use, TSSJ determines whether or not it wants BREAKS 
passed back to it. If so, bit 35 in .LFLAG is set ON to warn TSSM, and 
contrel returns to UPDAT. Otherwise, code 1 is passed to ALLOC (EP1 of 
TSSL), and control returns to UPDAT. 


Enabling Command Processing In Build Mode 


If return from SCAN] indicates that the input line contained a command, 
STGIO sets appropriate flags, and ends the courtesy call. On the next 
processing cycle, an EOF indicator is inserted in the upper half of the 
character count word of the command message and the user's preceding 
data lines (located in the buffer) are appended onto the user's 
collector file prior to enabling the command processing. A _ disc/drum 
write with courtesy call is issued, with return to RTCMD upon disc/drum 
termination. (The method of issuing the courtesy call is the same as 
mee discussed in the paragraph gene _with the exception that an RTCMD 


15 used instead cf RTNCM,) Flags FII T/O IN PROCESS ana Lo PT LE. 160 
are set on to aundicate that the file 1/O was initiated and its 
beyminabion must be Handled by Linc Service, 
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When the courtesy call is honored, RTCMD interrogates the file terminate 
status, and if normal, places a TSX3 DOCMD in the UST entry's .LOC 
location, sets appropriate flags, and ends the GENIOS courtesy call. 
Eventual execution of the TSX1 DOCMD causes a call to SCAN2, in TSSH, to 
initiate processes based on the command word. This action ends’ the 
build-mode cycle for that user. 


Termination 


On a given entry to the Line Service terminate processor, all lines with 
I/O in process are checked for terminates. If no terminates were 
received and time-sharing has nothing to do until a terminate is 
received, the Line Service routine sets an alarm clock with normal 
urgency. This allows batch jobs to use the processor with no 
interference from time-sharing, but does not normally allow time-sharing 
to be swapped. A terminate received from any I/O or a new user 
connection will break the alarm clock and GECOS III reenables 
time-sharing. 
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Keyboard input and output data is temporarily collected in line buffers. 
The line buffers are permanently assigned to the UST. At initialization 
time, each UST is initialized with the address of the line buffer which 


is a part of the UST. 


Note that on termination of a file I/O operation, the 
remote-I/O-in-process bit is often set in conjunction with other bits or 
a special flag in the status word, in order to simulate a remote I/O 
termination for the next cycle of terminate processing. Also, a bit in 
the second flag word, coding due to a GEROUT courtesy call, and an 
entrance to the same coding due to cyclic execution of the terminate 
processor (CC-ENTRANCE bit). Since much of the same code is executed at 
main level and at courtesy-call level, the distinction is necessary at 
these points: 


1. Issuance of MME GEROUT (Separate code exists for calls at 
either level). 


2. Termination of the coding sequence, i.e., MME GEENDC or 
continuation within Line Service. 
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LINSRV(EP1) LINSRV(EP1) 
TSSJ TSSJ 


LINE SERVICE 


LINSRV (EP1 of TSSJ) attempts to perform the following functions in the 
order listed: 

1. Write console messages. 

2. Check for new users on line. 

3. Process new users in NUQ. 


4. Check for terminals not doing remote I/O and process status for 
each. 


5. Check for terminals doing remote I/O and process status for 


each. 


The successful performance of each operation is dependent on timer 
limitations. 


TPTCATTITNG ecrntrNedTr 


a ee i ee 


None. 


CALLING SEQUENCE 


LINSRV is called from EXENTR, ALLOC, ALLOCI, ALL7AC, SWAP, NEWU76, SYS, 
TERMPG, CALLSS, NEWUSER, SYSRET, DRLABT, RETSBS, DRLRFL, PASFIL, RESTOR, 
GROW, CONSOL, PNTERR, DRLRET, TAPEIN, DRLDIO, FILACT, STPSYS, PPTOFF, 
PPTERM, TASK, and RELMEM. Control is never returned to the calling 
routine. 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 
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LINSRV(EP1) LINSRV(EP1) 


TSSJ 


ROUTINE RETURNS 


LITIAT mono ATT NOT 


TRA to WRAPUP when aborting TSS; to ALLOCI when users are on the 
but not using LINSRV; ZERO URGENCY when no users on the system. 
makes TSS available for swap. 


POSTCALLING SEQUENCE 


None. 


SUPPORTING INFORMATION 


Programming Method 


LINSRV is reentrant and relocatable. 


Interrupts are inhibited while checking for new ID. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Provide Date and Time of Day FGTIM (EP8 of .MFALT) 

MME GEINOS Processor INOS (EP5 of .MIOS) 

Release #S Links RELSPC (EP3 of TSSC) 

End Courtesy Call ENCC (EP5 of .MDISP) 

Core Size Adjustment ALL7AC (EP3 of TSSL) 

Line Service Check EXTSQ (EP2 of TSSM) 

Trace Recent Events TSEVNT (EP1 of TSSB) 

Dynamic UST Generator DYUST (EP1 of TSSN) 

MME GEROUT Processor GROUT (EP1 of .MROUT) 

New DATANET-760 User GOOD76 (EP2 of TSSO) 

TSS Subsystem Startup STARTP (EP5 of TSSI) 

Let Slave Program Enter Master Mode FEMM (EP10 of .MFALT) 
Relingquish Control Until Program Enabled DSCNT (EP11 of .MDISP) 
Set Alarm SCK (EP13 of .MDISP) 
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LINSRV (EP1) 
TSSJ 


Allocate Job in Queue ALLOCI (EP2 of TSSL) 


Rite fe past ay Ae: MONCH ) .£ mea 
Monitor Procedures MONCK (EP2 of TSSJ) 


Update Allocator Queue ALLOC (EP1 of TSSL) 
Interpret Primitive SCAN3 (EP3 of TSSH) 
System Message Generator SYS (EP4 of TSSTI) 
System Error ERROR (EP1 of TSSF) 

Scan for Control Languaye SCANi (EP1 of TSSH) 
Executive Disc I/O TSXDIO (EP3 of TSSK) 

Scan for Known Command Word SCAN2 (EP2 of TSSH) 
Special Entry PNTTSX (EP2 of TSSG) 


LINSRV(EP1) 
TSSJ 
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GECOS III 


MONCK (EP 2) 
TSSJ 


MONITOR PROCEDURES 


a ™ms> 


\ ~ 
TSSJ) allows am 
r 


MONCK (EP2 st 
user and the system. 


of 
between anothe 


PRECALLING SEQUENCE 


Prior to entering MONCK, the registers listed must 
indicated. 


X2 UST address 


Ae Armas ee 


CALLING SEQUENCE 


SMD TSS EXECUTIVE 


MONCK (EP2) 
TSSJ 


the interaction 


contain the data 


MONCK is called from the SYS, ALLOCI and KEYIO routines via: 


OPERATING SYSTEM 


|MONCK 

Imaster user 
Imonitored user 
jno monitoring 


INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to call+l if unsuccessful. 
Return is to call+2 if successful. 


88 


GECOS III SMD TSS EXECUTIVE 


MONCK (EP2) MONCK (EP 2) 
TSSJ TSSJ 


POSTCALLING SEQUENCE 


X7 Contains address of master UST if either master or monitored 
user is found. 


SUPPORTING INFORMATION 


Programming Method 
MONCK is reentrant and relocatable. 


Interrupts are inhibited while checking for master or monitored user. 


Storage 


wIEEMP 25 Used “to store x2 


Other Routines Used 


MME GEROUT Processor GROUT (EP1 of .MROUT) 
System Message Generator SYS (EP4 of TSSI) 
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GECOS III SND TSS EXECUTIVE 


LDED LDPED 
TSSJ TSSJI 


SYSTEM LOADED - REJECT NEW USER 


The LDED function of TSSJ issues a busy message to new user and ~sets 
flags for a disconnect when a new user is in NUQ but the system is 
loaded. This is also a return point from LINSRV extensions in TSSO. 


Prior to entering LDED, the registers listed must contain the data 
indicated. 


X5 Station ID 
X7 NUQ entry index 
A NUQ entry word 
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GECOS III SMD TSS EXECUTIVE 


GOOD10 GOOD10 
TSSJ TSSJ 


ENTER NEW USER IN UST AND UPDATE NUQ LOOP 


300D10 function of TSSJ upda 


1e 10 fu tes the count of user Ss the new 
user, sets flags for APB and continues to process the next new user. 
This is also a return from LINSRV extensions in TSSO. 


Prior to entering GOOD10, X2 contains the UST address. 
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GECOS III SMD TSS EXECUTIVE 


UPDAT UPDAT 
TSSJ TSSJ 


UPDATE TO NEXT ENTRY 


The UPDAT function of TSSJ finds the next terminal with its remote I/O 
flag on while LINSRV is processing the status of such terminals. This is 
also a return point from LINSRV extensions in TSSO. 


Prior to entering UPDAT, X2 contains the UST address. 
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GECOS III SMD TSS EXECUTIVE 


STGIO STGIO 
TSSJ TSSJI 


BUILD MODE PROCESSING OF INPUT 


The STGIO function of TSSJ initializes pointers for input, checks line 
mode, tests for a command input and starts appropriate action. This is 
also a return point from LINSRV extensions in TSSO. 


Prior to entering STGIO, the registers listed must contain the data 
indicated. 


X2 UST address 
X3 Current line pointer 
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GECOS III SMD TSS EXECUTIVE 


PPTCC1 PPTCeL 
TSSJ TSSJ 


PAPER TAPE COURTESY CALL 


The PPTCCl function of TSSJ processes paper tape input from the 


terminals and places the input on the TAP* file. 


Prior to entering PPTCCl, X2 contains the UST address. 


Entry is via a pseudo-courtesy call from DRLKON. 
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GECOS III SMD TSS EXECUTIVE 


DERAIL PROCESSORS (TSSK) 


The Derail Processors satisfy requests for executive services by a 
subsystem program in execution. A derail (DRL) instruction causes a 
fault to be returned via GECOS III to the TSS fault vector. The TSS 
executive modules then perform the requested action and return to the 
calling subsystem or another subsystem as required to process’ the 
request. 


The derail functions are similar to and replace MME functions in _ the 
GECOS system since a subsystem may not execute a MME instruction. The 
address portion of the DRL instruction defines the function to be 
performed. (See the Transfer Vector Table which follows.) 


In addition to the DRL routines, the TSSK module also contains nine 
entry points as follows: 


EP7 Executive File Spacing (TSXSPF) 
EP8 Search the AFT (SRCH) 
EP9 Switch File Names (TSXSWH) 


e EP1l Derail Entry from Executive (EXDRL) 

@ EP2 Return to Subsystem from Derail (RETSBS) 
e EP3 Executive Disc I/O (TSXDIO) 

@ EpP4 Buffer Dump (BUFDMP) 

@ EP5 Set Tally for Output Buffer (STBTAL) 

e@ EP6 Yransmit Data to Buffer (STORTUF) 

e 

e 

e 


TSSK occupies approximately 6130 (octal) core storage locations. 


Transfer Vector Table 


Transfer to Decimal 
DRL Derail Processor Address Function 
DIO TRA DRLDIO 1 DISC IO 
KOUT TRA DRLKOT 2 KEYBOARD OUTPUT 
KOUTN TRA DRLKON 3 KEYBOARD OUTPUT/INPUT 
KIN TRA DRLKIN 4 KEYBOARD INPUT CURRENT LINE 
RETURN TRA DRLRET 5 RETURN FROM SUBSYSTEM 
DEFIL TRA DRLFIL 6 DEFINE A FILE 
ABORT TRA DRLABT 7 ABORT JOB 
SETSWH TRA DRLSET 8 SET SWITCH WORD 
RS TSWH TRA DRLRST 9 RESET SWITCH WORD 
REW TRA DRLREW 10 REWIND FILE 
FILSP TRA DRLSPF ll SPACE A FILE(BACK-FWD SPACE) 
RETFIL TRA DRLRFL 12 RETURN A FILE 
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COATT TR 


USERID 
TERM 

PASUST 
MORLNK 
NEWUSR 
FILACT 
SETLNO 
SYS RET 
STPSYS 
STATUS 
DRLDSC 
PASDES 
JSTs 

CGROUT 
PART 

GROW 

ABTJOB 
CONSOL 
SWITCH 
DRLIMT 
JOUT 

KOTNOW 
OBJTIN 
PASFLR 
STOPPT 
DRLSAV 
TASK 

PSEUDO 
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RELMEM 
ADDMEM 
CORFIL 
SNUMB 
TIME 
PASAFT 
TERMTP 
PDIO 
RESTOR 
PASFIL 
DRLPPT 
CALLSS 
USERID 
TERMPG 
PASUST 
MORLNK 
NEWUSR 
FILACT 
SETLNO 
SYS RET 
STPSYS 
STATUS 
DRLDSC 
PASDES 
JSTS 
CGROUT 
PART 
GROW 
ABTJOB 
CONSOL 
DRLSWH 
DRLIMT 
JOUT 
OUTNOW 
OBJTIM 
PASFLR 
PPTERM 
SAVE 
TASK 
FAKEIN 


GECOS III SMD TSS EXECUTIVE 


RELEASE MEMORY 
ADD MORE MEMORY 
DATA FROM/TO CORE FILE 


fay?) 
OBTAIN SNUMB 


OBTAIN TIME, DATE, PROCESSOR TIME 
PASS AFT TO A SUBSYSTEM 

OBTAIN TERMINAL TYPE 

PRIVILEGED DISC I/O 

RESTORE (OVERLAY LOAD) 

PASS FILE TO BATCH 

PAPER TAPE INPUT 

INTERNAL CALL TO ANOTHER SS 

GIVE EXEC USER ID ADD PRIORITY 
USER TERMINATED-CLEAN UP UST 

PASS UST TO SYBSYSTEM 

REQUEST MORE LINKS 

LOGON A NEW USER W/O DISCONNECT 
PERM FILE REQUEST 

SET LINE NO./INC. IN UST 

RETURN TO SYSTEM 
FORGET SUBSYSTEM 
CHECK I/O STATUS (Not Implemented) 
DISCONNECT TERMINAL 

PASS FILE TABLE AND DESCRIPTION 
JOB STATUS 

PROCESS LINE SWITCH 

PARTIAL TEMP FILE RELEASE 

GROW A PERM FILE 

ABORT JOB 

TALK TO 600 CONSOLE 

SWITCH FILE NAMES 

STORE PROCESSOR TIME LIMIT 

BATCH OUTPUT REQUEST 

KEYBOARD OUTPUT FROM UNFILLED BUF. 
PROC. TIME AND CORE SIZE LIMIT 
PASS FILE TO REMOTE BATCH PROC. 
SEND "STOP PAPER TAPE" TO DATANET 
SAVE PROGRAMS ON PERM FILE 

SPAWN A SPECIAL BATCH ACTIVITY 
SIMULATED KEYBOARD INPUT 


TRUITT 
Lovo 


GECOS III SMD TSS EXECUTIVE 


EXDRL(EP1) EXDRL(EP1) 
TSSK TSSK 


ENTRY FROM EXECUTIVE 


TYR DT imrny7 mctewr \ 


EXDRL (EP1 of TSSK) stores the IC and I address in user's data region, 
finds the proper derail in the transfer vector table, sets X3 to point 


rram 


to the DRL address, sets XZ to point to the appropriate UST, and 
transfers control to the derail routine. 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


EXDRL is called from EXENTR as a result of a DRL fault occurring within 
an active subsystem. 


8 16 
| ! 
| TSX1 'EXDRL 


Error return 
Normal return 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Normal return is to the specified derail processor. Error return is to 
DRLER1 to print DRL code. 
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GECOS III SMD TSS EXECUTIVE 


EXDRL(EP1) EXDRL(EP1) 
TSSK TSok 


POSTCALLING SEQUENCE 


None. 


SUPPORTING INFORMATION 


Programming Method 


EXDRL is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Return to Subsystem from Derail RETSBS (EP2 of TSSK) 
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RETSBS (EP2) RETSBS (EP2) 
TSSK TSSK 


RETSBS (EP2 of TSSK) counts the number of consecutive returns to 
subsystem execution (limit, 30). If not over limit, returns to subsystem 
execution. If over limit, forces a return through LINSRV. 


PRECALLING SEQUENCE 


Prior to entering RETSBS, the X2 register must contain the UST address. 


CALLING SEQUENCE 


RETSBS is called from ALLOCI, EXDRL, TASK, DRLKON, DRLKOT, DRLKIN, 
DRLSET, DRLDIO, DRLSPF, DRLFIL, DRLRFL, PASAFT, CORFIL, SNUMB, TINE, 
TERMTP, USERID, TERMPG, NEWUSR, PASUST, MORLNK, PASFIL, RELMEM, ADDMEM, 
SETLNO, PASDES, JSTS, DRLSWH, CCROUT, PART, ABTJOB, PPTIRM, and 


wtp a Sha , mBbLUOCL, rium, ana 
vila: 


8 16 


IRETSBS 
Return | 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


If the count of returns to subsystem execution is not over 30, return is 
to RETSSX in TSSM; if over 30, return is to LINSRV. 
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RETSBS (EP2) 
TSSK 


POSTCALLING SEQUENCE 


None. 


SUPPORTING INFORMATION 


Programming Method 
RETSBS is nonreentrant and relocatable. 


Interrupts are not inhibited. 


storage 


No internal temporary storage is used. 


Other Routines Used 


None. 
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GECOS III 


SMD TSS EXECUTIVE 


RETSBS (EP 2) 
TSSK 


GECOS III SMD TSS EXECUTIVE 


TSXDIO(EP3) TSXDIO(EP3) 
TSSK TSSK 


EXECUTIVE DISC 1/0 


TSXDIO (EP3 of TSSK) performs the I/O for routines within the TSS 
Executive. It sets flags, stores pointers, courtesy calls and status, 
and goes to DRLDIO for actual input/output. 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


TSXDIO is called from PASFIL, EXENTR, DRLABT, RESTOR, FLUSH, SAVE, TASK 
and ERRORT via: 


1TS¥ I ImayntTo 

SEEK 

ZERO ;L(file I/D) ,L(DCW1) 
READ/WRITE COMMAND 

ZERO {L(file I/D) ,L(DCW2) 

ZERO iL(status) ,L (courtesy call) 
Return '! 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to DRLDIO. 
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GECOS III SMD TSS EXECUTIVE 


TSXDIO (EP3) TSXDIO(EP3) 
TSSK TSSK 


POSTCALLING SEQUENCE 


None. 


SUPPORTING INFORMATION 


Programming Method 
TSXDIO is nonreentrant and relocatable. 


Interrupts are not inhibited. 


storage 


Internal temporary storage is used to save registers. 


Other Routines Used 


Search the AFT SRCH (EP8 of TSSK) 
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GECOS III SMD TSS EXECUTIVE 


BUFDMP (EP4) BUFDMP (EP4) 
TSSK TSSK 


BUFFER DUMP 


BUFDMP (EP4 of TSSK) dumps the buffer contents to the remote terminal. 


PRECALLING SEQUENCE 


Prior to entering BUFDMP, the registers listed must contain the data 
indicated. 


A L(courtesy call),(0 or 1) 
0 Write only 
1 Write then read 


CALLING SEQUENCE 


BUFDMP is called from DRLKON, NEWU76, PNTERR, DRLRET, DRLEKOT, PAREIN, 
DRLDSC and SYSRET modules. 


8 16 


| 
TSX1 | BUFDMP 
Return 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to calling routine. 
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BUFDMP (EP4) 
TSSK 


POSTCALLING SEQUENCE 


SUPPORTING INFORMATION 


Programming Method 


BUFDMP is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Initiate Remote I/O KEYIO (EP2 of TSSI) 
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GECOS 


III SMD TSS EXECUTIVE 


BUFDMP (EP4) 
TSSK 


GECOS III SMD TSS EXECUTIVE 


STBTAL (EP5) STBTAL (EP5) 
TSSK TSSK 


SET TALLY FOR OUTPUT BUFFER 


CAmnNnMmaAT {PDE nF TSSK) antea than fal les Far #FhAAR Nniiknitk Aiif Far a = a+ aca nat 
wid itiss \aul wv WL bwin] welw VLlLe LAL Ly itv LOS © Swe VUCPUL WULL iL iL Lu bo sil 
already set. If it is set, STBTAL returns immediately. 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


STBTAL is called from DRLKON and PNTERR via: 


8 16 
| 
| TSXL ISTBTAL 
j Return 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to calling routine. 


POSTCALLING SEQUENCE 


AU - Tally stored in second word. 
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GECOS III SMD TSS EXECUTIVE 


STBTAL(EP5) STBTAL (EP5) 
TSSK TSSK 


SUPPORTING INFORMATION 


Programming Method 


STBTAL is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


None. 
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GECOS III SMD TSS EXECUTIVE 


STOBUF (EP6) STOBUF (EP6) 


TSSK 


TRANSMIT DATA TO BUFFER 


PRECALLING SEQUENCE 


Prior to entering STOBUF, the registers listed must contain the 
indicated. 


A Input tally word (TALLYB) 
Q Character string to be added 


CALLING SEQUENCE 
STOBUF is called from the DRLKON and PNTERR via: 


8 16 


i] 
TSX1 \STOBUF 
Return (input tally not run out) 
Return (both tallies run out) 
Return (data in buffer) 


OPERATING SYSTEM INTERACTION 
No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to calling routine. 


TSSK 


data 
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STOBUF (EP6) 
TSSK 


POSTCALLING SEQUENCE 


Na 
None. 


SUPPORTING INFORMATION 


Programming Method 


GECOS III SMD TSS EXECUTIVE 


STOBUF is nonreentrant and relocatable. 


Interrupts are not inhibited. 
Storage 
Locations, .TCTM3, 4, and 5 are 


character string. 


Other Routines Used 


None. 
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used to store 


tallies 


STOBUF (EP6) 
TSSK 
and insert 


TSXSPF (EP7) 


TSSK 

FILE 
TSXSPF (EP7 of TSSK) performs file 
Executive. It sets the pointers to 
file ID, then goes to DRLSPF to do 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


TSXSPF is called from PASFIL, TASK, 


GECOS III SMD TSS EXECUTIVE 


TSXSPF (EP7) 


SPACING 

Spacing for routines within the 
number of records, status return 
actual spacing. 


EXENTR and DRLABT via: 


[ | 


8 16 

| TSX1 |TSXSPF 

| ZERO ln(£ilectD):, 
ZERO ln(status), 0 
Return | 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used, 


No gates are used. 


ROUTINE RETURNS 


Return is to DRLSPF. 


POSTCALLING SEQUENCE 


None. 


Li{number of 320-word blocks 
I to be spaced) 


TSSK 


TSS 
and 
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GECOS III SMD TSS EXECUTIVE 


TSXSPF (EP7) TSXSPF (EP7) 
TSSK TSSK 


SUPPORTING INFORMATION 


Programming Method 


TSXSPF is nonreentrant. 


Interrupts are not inhibited. 


Uses common code in DRLSPF. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


None. 
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GECOS III SMD TSS EXECUTIVE 


SRCH (EP 8) SRCH (EP8) 
TSSK TSSK 


SEARCH THE AFT 


PRECALLING SEQUENCE 


AQ contains file name in ASCII. 


CALLING SEQUENCE 


SRCH is called from EXENTR, SAVE, TASK, PASFIL, DRLPPT, TSXDIO, DRLDIO, 
DRLSPF, DRLFIL, DRLRFL, FILACT, MORLNK, PASFIL, DRLABT, RESTOR, PART, 
GROW and DRLSWH via: 


8 16 
| ok hoe ! ae 
TSA/ 1oRCH 
Return '! 
3 


OPERATING SYSTEM INTERACTION 
No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Returns to calling routine. 


POSTCALLING SEQUENCE 
A contains offset to PAT pointer, 
PAT pointer (contains permissions) 


0 aif file is found 
QO if file is not found 


A # 


aed 


GECOS III SMD TSS EXECUTIVE 


SRCH (EP8) SRCH (EP 8) 
TSSK TSSK 


SUPPORTING INFORMATION 


Programming Method 


SRCH is nonreentrant and relocatable. 


Interrupts are inhibited during master mode processing. 


Storage 


Internal temporary storage is used for storing registers. 


Other Routines Used 


Let Slave Program Enter Master Mode FEMM (EP10 of .MFALT) 
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GECOS III SMD TSS EXECUTIVE 


TSXSWH (EP9) TSXSWH (EP9 ) 


TSSK 
SWITCH FILE NAMES 


TSXSWH (EP9 of TSSK) performs switc 
temporary files. It stores the pointers 
actual switching of names. 


: 
hing of names a 


ssigne 
nd goes to DRLSWH_ for 
PRECALLING SEQUENCE 

None. 


CALLING SEQUENCE 


TSXSWH is called by PATDEA when a user is logging-off. 


8 16 
P I PaaS 
j LSXL iTSASWH 
ZERO iL (filename 1),L(filename 2) 


Tie biped 
j aeouuiil 1 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


POSTCALLING SEQUENCE 


A register contains error return, if any: 


File not open 
File not temporary 


HO 


TSSK 


two 
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GECOS III SMD TSS EXECUTIVE 


TSXSWH (EP9) TSXSWH (EP9) 
TSSK TSSK 


SUPPORTING INFORMATION 


Programming Method 


TSXSWH is nonreentrant and relocatable. 


Interrupts are inhibited during master mode processing. 


Other Routines Used 


None. 
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GECOS III SMD TSS EXECUTIVE 


DRLDIO(DRL DIO) DRLDIO(DRL DIO) 
TSSK TSSK 


DISC I/O DERAIL 


et Sie alas 


DRLDIO (DRL DIO, TSSK) is used for files that appear in ae user's 
Available File Table (AFT). It takes the equivalent of the calling 
sequence to GENIOS and performs the indicated seek, read, or write, 
using the master mode routines, .QUEUE and -LINK. It notifies the 
time-sharing system Allocator that I/O is being done, and to suspend 
subsystem execution, but not to swap. When the I/O is completed, the 
Allocator will again be notified, and the subsystem made eligible for 
execution. All hardware status is returned except device-busy, as such. 
Undefined file is returned as device-busy status (major status 01) and 
logical end of file as major status 17. If the terminal user does not 
have the necessary permissions, or if an invalid relative block number 
is given for a random file, the requesting subsystem is aborted and an 
error message is sent to the terminal. 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


DRLDIO is called from any TSS subsystem through EXDRL via: 


8 16 
| 


DRL IDTO 
SEEK command 
ZERO 'n(file ID) ,L(DCW1) 
READ/WRITE command 
ZERO 1L(file ID) ,L(DCW2) 
ZERO IL(status) ,0 
Return | 
where: 
fileid (2 words) contains the filename in ASCII - 1 to 8 


characters. 


dcewl - IOTD L(rbn),l 
where rbn contains, for random files, the relative block 


number (set by user). This word is always altered by I/0 
routines. 
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GECOS III SMD TSS EXECUTIVE 


DRLDIO(DRL DIO) 
TSSK 


dew2 - IOTD L(data) ,n 


DRLDIO(DRL DIO) 
TSSK 


where data contains the starting address at which data is to 
be read/written, and n is the number of words to be 


transferred. 


I/O commands - The user need not be concerned about giving commands 
for a specific device type. The seek (34) command, write (31) 
command, and read (25) command will be accepted for all 
devices. The actual commands used will be acquired from the 


channel module for the particular device. 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 
ROUTINE RETURNS 
Returns to the calling subsystem if validation error or 


via Courtesy Call if I/O is issued. 


POSTCALLING SEQUENCE 


None. 
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through LINSRV 


GECOS III SMD TSS EXECUTIVE 


DRLDIO(DRL DIO) DRLDIO(DRL DIO) 
TSSK TSSK 


SUPPORTING INFORMATION 


DRLDIO verifies that the user has the appropriate permission before he 
is allowed to read or write. In order to handle the EXECUTE permission, 
some additional tests must be performed. 


If a file read is requested and the open file does not have READ 
permission, a check will be made to see if the requesting subsystem is 
one of the following processors: 


BASIC (BASY) 

FORTRAN (RUN) 

CARDIN (CDIN) 
If it is one of the above, a further check will be made to see if 
EXECUTE permission was granted on the opened file and if so the file 


read will be done. A read from one of the above subsystems is done only 
as the result of a RUN command. 


Programming Method 


DRLDIO is nonreentrant and relocatable. 


Interrupts are inhibited while I/O is being done. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Update Allocator Queue ALLOC (EP1 of TSSL) 

Line Service LINSRV (EP1 of TSSJ) 

End Courtesy Call ENCC (EP5 of .MDISP) 

Print Error Message PNTERR (EP1 of TSSG) 

Return to Subsystem from Derail RETSBS (EP2 of TSSK) 
Assign an I/O Entry QUEUE (EP4 of .MIOS) 

Link I/O to End of Queue LINK (EP1 of .MIOS) 

Relinguish RLC (EP4 of .MDISP) 

Search the AFT SRCH (EP8 of TSSK) 

Let Slave Program Enter Master Mode FEMM (EP10 of .MFALT) 
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GECOS III SMD TSS EXECUTIVE 


DRLKOT (DRL KOUT) DRLKOT (DRL KOUT) 
TSSK TSSK 


KFYBOARD OUTPUT 


DRLKOT (DRL KOUT, TSSK) accumulates the user's output in a buffer for 
eventual output to the keyboard. When the buffer is full, output to the 
keyboard is initiated. At this point, execution of the subsystem is 
inhibited and the subsystem made eligible for swap. When the output is 
complete, the program is again eligible for execution. 


PRECALLING SEQUENCE 


Prior to entering DRLKOT, the A-register will contain the KOUT/IN 
indicator if entry is from DRLKON. 


CALLING SEQUENCE 


DRLKOT is called from any TSS subsystem through EXDRL via: 


DRL IKOUT 
ZERO IL(tally) ,L(char) 
Return | 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to LINSRV. 


POSTCALLING SEQUENCE 


None. 
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GECOS III SMD TSS EXECUTIVE 


DRLKOT (DRL KOUT) DRLKOT (DRL KOUT) 
TSSK TSSK 


SUPPORTING INFORMATION 


The field L(tally) points to a driver tally word pointing in turn to a 
list of line TALLYB words which define each line of output ASCII 
characters to be sent to the keyboard. The driver tally has the count of 
the line taliies in the list. This ailows the user to define scattered 
lines, not necessarily starting at word boundaries. The derail processor 
utilizes the tally words and they may be modified on return to the 
subsystem. 


The optional field L(char) points to a word containing up to four 
characters that will be appended to the end of the output defined by 
each line tally. These characters could be line feed, carriage return, 
etc. If this field is not present in the calling sequence, no characters 
will be added. If the field is present, the first zero character 
terminates the appending of characters. In any case, no more than _ four 
characters will be appended. Note: Because of timing considerations and 
character set differences between terminal types, the carriage return 
characters should always precede the line feed character and one or two 
delete characters. 


Prearammina Method 
DRLKOT is nonreentrant. 


Interrupts are inhibited during output. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Set Tally for Output Buffer STBTAL (EP5 of TSSK) 
Return to Subsystem from Derail RETSBS (EP2 of TSSK) 
Line Service LINSRV (EP1 of TSSJ) 

Transmit Data to Buffer STOBUF (EP6 of TSSK) 

Update Allocator Queue ALLOC (EP1 of TSSL) 

Pass AFT to a Subsystem PASAFT (DRL PASAFT, TSSK) 
Paper Tape Courtesy Call PPTCC1 (TSSJ) 


Lig 


GECOS III SMD TSS EXECUTIVE 


DRLKON (DRL KOUTN) DRLKON (DRL KOUTN) 
TSSK TSSK 


KEYBOARD OUTPUT / INPUT 


DRLKON (DRL KOUTN, TSSK) sends output to the keyboard device and holds 
the line open for a reply. It differs from DRL KOUT only in that a reply 
is expected from the keyboard device. 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


DRLKON is called from any TSS subsystem through EXDRL via: 


8 16 
I 
DRL ;KOUTN 
ZERO IL(tally) ,L(char) 
Return 


See DRLKOT for more details. 
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DRLKIN(DRL KIN) DRLKIN(DRL KIN) 
TSSK TSSK 


RETRIEVE LAST LINE OF INPUT 


DTrvrTr {nor Ww moot \ we tri ja ay go me es of ra 


DRLKIN (DRL KIN, TSSK) retrieves the last line input. It normally : 
follows the KOUTN sequence. This is not necessary, however, and the DRL 
KIN may be repeated as many times as desired in repetitive processes 


——— eo 


such as those performed by EDIT, LIST, or BASIC. The iast line wiii 
remain in the buffer until some output or additional input destroys it. 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


DRLKIN is called from any TSS subsystem through EXDRL via: 


8 16 
I 
| DRL IKIN 
ZERO pitdata) ,Lu(count of chars. to be transmitted 
or zero if there is no data) 
ZERO nseeauue) (see DRLKOT) 
Return | 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to RETSBS. 
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DRLKIN(DRL KIN) 
TSSK 


POSTCALLING SEQUENCE 


SUPPORTING INFORMATION 


Programming Method 


DRLKIN is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


None. 
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DRLKIN (DRL KIN) 
TSSK 


GECOS III SMD TSS EXECUTIVE 


DRLRET (DRL RETURN) DRLRET(DRL RETURN) 
TSSK TSSK 


RETURN FROM SUBSYSTEM 


DRLRET (DRL RETURN, TSSK) informs the Executive that this subsystem 
process has reached a normal termination. TSSH selects the next 
primitive in the sequence defined in the program descriptor and, based 
on this primitive, initiates the next process, 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


DRLRET is called from any TSS subsystem through EXDRL via: 


8 16 
| i 


DRL IRETURN 


H Teen # caer 
| BS ol ee oe es i 


OPERATING SYSTEM INTERACTION 
No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to LINSRV. 
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DRLRET (DRL RETURN) 
TSSK 


POSTCALLING SEQUENCE 


None. 


SUPPORTING INFORMATION 


Programming Method 


DRLRET is nonreentrant and relocatable. 


Interrupts are not inhibited. 


storage 


No internal temporary storage is used. 


Other Routines Used 


Update Allocator Queue ALLOC (EP1 of TSSL) 
Interpret Primitive SCAN3 (EP3 of TSSH) 
Line Service LINSRV (EP1 of TSSJ) 

Buffer Dump BUFDMP (EP4 of TSSK) 
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DRLRET(DRL RETURN) 
TSSK 


GECOS III SMD TSS EXECUTIVE 


DRLFIL(DRL DEFIL) DRLFIL(DRL DEFIL) 
TSSK TSSK 


DEFINE A TEMPORARY FILE 


RIL 


L (DRL DEFIL, TSSK) obtains space for a re 


wi Sik 4 i a wwly 21D erect 


DRLFI 
builds a PAT entry, and enters the file in the 


PRECALLING SEQUENCE 


Prior to entering DRLFIL, .TFTEM must contain the device type for 
temporary files. 


CALLING SEQUENCE 


DRLFIL is called from any TSS subsystem via: 


8 16 
| DRL jDEPIL 
| ERO jL(File ID), L(Status) 
| KelULL 
where: 
FILE ID 0 2324 35 
filename (chars. 1-4) Status 
Si filename (chars. 5-8) Poo 


0 56 16171819 35 


+2 Device Number of links 
Type X| desired (binary) 


Status (in binary) may be: 


Successful 

No room in AFT 

Temporary file not available 
Duplicate file name 

No room in PAT 

Illegal device specified 


SO UB WD © 
tou te wea 
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DRLFIL(DRL DEFIL) 


TSSK 


Device type is: 


Bit 17 


Bit 18 


KO 


HO 


GECOS III SMD TSS EXECUTIVE 


DRLFIL(DRL DEFIL) 
TSSK 


DSU270 
DSU200 
DSU167 
MDU200 
MSS 800 
DSS170 
DSS180 


Use the system file device defined in .TFTEM. 
Use device specified in ID+2. 


Linked file 
Random file 


OPERATING SYSTEM INTERACTION 


No gates are used. 


ROUTINE RETURNS 


Return is to RETSBS. 


POSTCALLING SEQUENCE 


Upon successful return, A contains the file description, as follows: 
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or 


Bits 


0-5 

6-17 
18=0 
24-35 


18=1 
24-35 


19=0 
19=1 
20=0 
20=1 
21-23 


Device type (as above) 
Number of words in block 


Number of links in file 


Number of blocks in file 


Linked file 
Random file 
Temporary file 
Permanent file 
Unused 


GECOS III SMD TSS EXECUTIVE 


DRLFIL(DRL DEFIL) DRLFIL(DRL DEFIL) 
TSSK TSSK 


This information is also returned when an already defined file is 
requested. 


SUPPORTING INFORMATION 


When a temporary file is requested, bit 17 of LOC+2 is examined to 
determine if the file is to be a specific device. If the requested file 
is to be on the system file, the device type is defined in .TFTEM. This 
word resides in the time-sharing Communication Region and can be changed 
according to the requirements of a particular site. If a specific device 
is requested but there is not enough space on that device, the request 
will be satisfied automatically from the system device. 


Programming Method 
DRLFIL is nonreentrant. 


ts are not inhibited 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Search the AFT SRCH (EP8 of TSSK) 

Let Slave Program Enter Master Mode FEMM (EP10 of .MFALT) 
Process Specific Device Request ENTRY (EP1l of .MALC2) 
File Entry Space Allocation PATMAN (EP1 of TSSD) 

Return LINKS/LLINKS to the Pool ONE (EP1 of .MALC9) 
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DRLABT (DRL ABORT) DRLABT (DRL ABORT) 
TSSK TSSK 


ABORT USER 


DRLABT (DRL ABORT, TSSK) aborts the user when an abnormal sequence 
occurs during processing. 


If the user has defined a file with the name ABRT, a core dump of the 
subsystem will be written to that file. In any case, a message will be 
sent to the terminal stating that an abort has occurred and the user is 
free to select a new system. 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


DRLABT is called from any TSS subsystem through EXDRL via: 


8 16 
DRL 'DRLABT 


Return | 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


ROUTINE RETURNS 


Returns to calling subsystem. 
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DRLABT (DRL ABORT) 
TSSK 


POSTCALLING SEQUENCE 


None. 


SUPPORTING INFORMATION 


Programming Method 


DRLABT is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Other Routines Used 


Search the AFT SRCH (EP8 of TSSK) 


Update Allocator Queue ALLOC (EP1 of TSSL) 


File Spacing TSXSPF (EP7 of TSSK) 
Line Service LINSRV (EPl of TSSJ) 


Print Error Message PNTERR (EP1 of TSSG) 


End Courtesy Call ENCC (EP5 of .MDISP) 
Special Entry PNTTSX (EP2 of TSSG) 
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DRLABT (DRL ABORT) 
TSSK 
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DRLSET (DRL SETSWH) 
TSSK 


SET SWITCH WORD 


DRLSET (DRL SETSWH, TSSK) sets the bits in the 
(,.LSWTH) provided in each of the UST blocks 
individual user. 


PRECALLING SEQUENCE 


III SMD TSS EXECUTIVE 


DRLSET (DRL SETSWH) 
TSSK 


36-bit switch word 
associated with an 


Prior to entering DRLSET, the registers listed must contain the data 


indicated. 


Q Contains respective bits which are to be set 


in the switch word .LSWTH (see UST). 


CALLING SEQUENCE 


DRLSET is called from any TSS module through EXDRL via: 


8 16 

| 
DRL |SETSWH 
Return | 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


ROUTINE RETURNS 


Return is to RETSBS. 
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DRLSET (DRL SETSWH) DRLSET (DRL SETSWH) 
TSSK TSSK 


POSTCALLING SEQUENCE 


Q Contains switch word 


SUPPORTING INFORMATION 


The value of the Q-register is OR'd into the switch word. Thus, any bit 
that is "on" or "true" will be set true in the switch word. Other bits 
will not be disturbed. The value returned in the Q-register is the 
resultant setting of the switch word. This provides a method of reading 
the switch word and determining a course of logic based on events in 
preceding subsystem processes. Thus, if one subsystem process encounters 
an abnormal situation, a prearranged bit may be set and subsequent 
subsystems may interrogate the switch word and take appropriate action. 
In order to obtain some measure of discipline in the use of this 
feature, the first 18 bits (0-17) are reserved for usage by systems 
issued with the time-sharing system. The lower 18 bits are free for use 
by subsystems generated by users. 


Programming Method 


DRLSET is nonreentrant and relocatable. 


Interrupts are not inhibited. 


storage 


No internal temporary storage is used, 


Other Routines Used 


None. 
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DRLRST (DRL RSTSWH) DRLRST(DRL RSTSWH) 
TSSK TSSK 


RESET SWITCH WORD 


DRLRST (DRL RSTSWH, TSSK) turns off each bit in the switch word. 


PRECALLING SEQUENCE 


Prior to entering DRLRST, the registers listed must contain the data 
indicated. 


Q contains respective bits which are to be rest 
in the switch word .LSWTH (See UST). 


CALLING SEQUENCE 


DRLRST is called from any TSS subsystem through EXDRL via: 


1 

| 

Return | 
| 


See DRLSET for further details. 
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DRLREW (DRL REW) DRLREW(DRL REW) 
TSSK TSSK 


DRLREW (DRL REW, TSSK) rewinds the specified linked file. It checks the 
calling sequence, sets the rewind flag and then transfers to the 


to rewind a random file causes a subsystem abort and an error message is 
sent to the terminal. 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


DRLREW is called from any TSS subsystem through EXDRL via: 


8 16 

DRL |REW 

ZERO IL(File ID),L(Status) 
Return , 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to DRLSPF. 
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DRLREW (DRL REW) 
TSSK 


POSTCALLING SEQUENCE 


Rewind flag is stored in SPFLAG. 


SUPPORTING INFORMATION 


Programming Method 


DRLREW is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Uses common code in DRLSPF. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


None. 
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DRLREW (DRL REW) 
TSSK 


GECOS III SMD TSS EXECUTIVE 


DRLSPF(DRL FILSP) DRLSPF (DRL FILSP) 
TSSK TSSK 


FORWARD / BACKSPACE A FILE 


DRLSPF (DRL FILSP, TSSK) spaces a linked file forward or backward n 
blocks. If a request is made to space a random file, the requesting 
subsystem is aborted and an error message is sent to the terminal. 
PRECALLING SEQUENCE 
None. 
CALLING SEQUENCE 
DRLSPF is called from any TSS subsystem through EXDRL via: 
8 16 
| | 
} DRL \FILSP 
| ZERO jL (File ID),L(number of 320-word blocks to be 
| Spaced. Negative number indicates 
| backspace.) 
ZERO IL (Status), 0 
Return | 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 
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DRLSPF(DRL FILSP) 
TSSK 


ROUTINE RETURNS 


GECOS III 


TRA pre (if call was TSX to TSXSPF) or 


TSX1 RETSBS 


POSTCALLING SEQUENCE 


Possible status returns: 


Loadpoint (0002) 
Logical End-of-file (1700) 
Device Busy, Undefined File (01) 


SUPPORTING INFORMATION 


Programming Method 


DRLSPF is nonreentrant. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Print Error Message PNTERR (EP1 of TSSG) 


Return to Subsystem from Derail RETSBS (EP2 of TSSK) 


Search the AFT SRCH (EP8 of TSSK) 


SMD TSS EXECUTIVE 


DRLSPF (DRL FILSP) 
TSSK 


Let Slave Program Enter Master Mode FEMM (EP10 of .MFALT) 
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DRLRFL(DRL RETFIL) 


TSSK 


III SMD TSS EXECUTIVE 


DRLRFL(DRL RETFIL) 
TSSK 


RELEASE A FILE 


DRLRFL (DRL RETFIL, 


TSSK) a 
specified file or all files except 


O 
Ky 


When a temporary file is returned, the file space and PAT entry space is 
released and the file deleted from the AFT. When a permanent file is 
returned, the file system is notified to deaccess the file, the PAT 
entry space is released, and the file deleted from the AFT. 


Note: A file that cannot be found in the AFT is considered by DRLRFL to 
be already released. 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


DRLRFL is called from any TSS subsystem through EXDRL via: 


8 16 
| 
DRL jRETFIL 
ZERO IL(File ID), L(Buffer) 
Return 
where: 
File ID (2 words) contains the file name in ASCII, or a 
right-justified 777 (in word 1) if all files (except 
SY**) are to be returned. 
buffer (BSS 380) is a work area used by the system; this area 


is not required for temporary files. 
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DRLRFL(DRL RETFIL) 
TSSK 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to RETSBS. 


POSTCALLING SEQUENCE 


None. 


SUPPORTING INFORMATION 


Programming Method 


DRLRFL is nonreentrant and relocatable. 


Interrupts are not inhibited. 


storage 


No internal temporary storage is used. 


Other Routines Used 


GECOS 


III SMD TSS EXECUTIVE 


DRLRFL(DRL RETFIL) 
TSSK 


Return to Subsystem from Derail RETSBS (EP2 of TSSK) 


Search the AFT SRCH (EP8 of TSSK) 
File Deallocation PATDEA (EP2 of TSSD) 


Let Slave Program Enter Master Mode FEMM (EP10 of .MFALT) 
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RELMEM (DRL RELMEM) RELMEM (DRL RELMEM) 
TSSK TSSK 


RELMEM (DRL RELMEM, TSSK) reduces the size of core required by a 


subsystem execution. It can also be used to change the register storage 


location only, without releasing memory. 


PRECALLING SEQUENCE 


Prior to entering RELMEM, the registers listed must contain the data 
indicated. 


A - Return location, register-storage location 
Q - Number of words low, number of words high 


CALLING SEQUENCE 


RELMEM is called from any TSS subsystem through EXDRL via: 


8 16 
DRL | RELMEM 
Return { 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to RETSBS. 
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RELMEM (DRL RELMEM) RELMEM (DRL RELMEM) 
TSSK TSSK 


POSTCALLING SEQUENCE 


None. 


SUPPORTING INFORMATION 


The number of words to be released from the lower portion of the 
subsystem is in the left-half of the Q-register and the number of words 
to be released from the upper portion of the subsystem is in the 
right-half of the Q-register. Both these values must be in blocks’ of 
1024 words or will be used mod 1024. 


Programming Method 


RELMEM is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Storage 


Internal temporary storage is used for storing registers. 


Other Routines used 


Update Allocator Queue ALLOC (EP1 of TSSL) 
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ADDMEM(DRL ADDMEM) ADDMEM(DRL ADDMEM) 
TSSK TSSK 


ADDMEM (DRL ADDMEM, TSSK) requests additional core required by a 
subsystem program during execution. 


PRECALLING SEQUENCE 


Prior to entering ADDMEM, the registers listed must contain the data 
indicated. 


A - Return location, register storage location 
Q - 0, number of words high 


CALLING SEQUENCE 


Ty teT x 


LADRKRL via: 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to RETSBS. 


POSTCALLING SEQUENCE 


None. 
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ADDMEM (DRL ADDMEM) ADDMEM (DRL ADDMEM) 
TSSK TSSK 


SUPPORTING INFORMATION 


The value in Q is interpreted as a request for additional memory. Only 
high memory may be requested. If memory is not available adjacent to the 
requesting subsystem, the subsystem will be swapped out. It is not 
possible to add memory to the lower end of a subsystem region. 


Programming Method 


ADDMEM is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Update Allocator Queue ALLOC (EP1 of TSSL) 
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CORFIL(DRL CORFIL) CORFIL(DRL CORFIL) 
TSSK TSSK 


READ / WRITE CORE FILE 


CORFIL (DRL CORFIL, TSSK) passes data from one subsystem to another 
without accessing a mass storage device. The core file is ten words of 
the user status table space. 


PRECALLING SEQUENCE 


Prior to entering CORFIL, the registers listed must contain the data 
indicated. 


A - 0-17 - Location within subsystem where data is to be read in 
or written out 
18-35 - Number of words to be transmitted 


Q - 0-17 - Number of core file cell at which transmission is to 
begin 
18-35 - 0 = Subsystem to core file 


1 Core file to subsystem 


CALLING SEQUENCE 


CORFIL is called from any TSS subsystem through EXDRL via: 


8 16 
DRL ! CORFIL 
Return 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to RETSBS. 
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CORFIL(DRL CORFIL) CORFIL(DRL CORFIL) 
TSSK TSSK 


POSTCALLING SEQUENCE 


None. 


SUPPORTING INFORMATION 


Programming Method 
CORFIL is nonreentrant and relocatable. 


Interrupts are not inhibited. 


storage 


No internal temporary storage is used. 


Other Routines Used 


Print Error Message PNTERR (EP1 of TSSG) 
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SNUMB(DRL SNUMB) SNUMB (DRL SNUMB) 
TSSK TSSK 


OBTAIN SNUMB 


SNUMB (DRL SNUMB, TSSK) asSigns SNUMB's to batch jobs spawned by 
subsystem programs. The numbers range from 1 to 7777 (octal). When 7777 
is reached, the sequence begins again. The initial SNUMB is set by 
TSTART according to time of day at startup. 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


SNUMB is called from any TSS subsystem through EXDRL via: 


8 16 
f ; 
DRL | SNUMB 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to RETSBS. 


POSTCALLING SEQUENCE 


A contains the SNUMB in BCI format. 


t 
m 
ow 


SNUMB (DRL SNUMB) 
TSSK 


SUPPORTING INFORMATION 


Programming Method 


SNUMB is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


None. 
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SNUMB(DRL SNUMB) 
TSSK 


GECOS III SMD TSS EXECUTIVE 


TIME(DRL TIME) TIME (DRL TIME) 
TSSK TSSK 


OBTAIN PROCESSOR TIME, DATE, TIME OF DAY 


TIME (DRL TIME, TSSK) returns the processor time used and time of day. 
It also returns the date upon request. 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


TIME is called from any TSS subsystem through EXDRL via: 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to RETSBS. 


POSTCALLING SEQUENCE 


A - Sum of processor time for user (1/64 ms) 
Q- Time of day (1/64 ms from midnight) 
L date - MM/DD/YY in ASCII, if requested 
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TIME(DRL TIME) 
TSSK 


SUPPORTING INFORMATION 


Programming Method 
TIME is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Provide Date and Time of Day FGTIM (EP8 of 
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.»MFALT) 


TIME (DRL TIME) 
TSSK 
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PASAFT (DRL PASAFT) PASAFT (DRL PASAFT) 
TSSK TSSK 


PASS AFT TO A SUBSYSTEM 


PASAFT (DRL PASAFT, TSSK) places the names of the files in the user's 
AFT in the area specified and returns it to the subsystem. 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


PASAFT is called from any TSS subsystem through EXDRL via: 


DRL IPASAFT 


ZERO pu(altarea;,iiiiax, number of files to ve 
| passed. If zero, all files 
; ae 
ro rene peveeu, 


Return 


where: 
aftarea is 2 X number of files to be passed, plus one, formatted as 


follows: 


Word 1 - Number of files in AFT 
Word 2 - Chars. 1-4 of first filename 
Word 3 - Chars. 5-8 of first filename 


Word n*2 - Chars. 1-4 of nth filename 
Word n*2+4+1 Chars. 5-8 of nth filename 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 
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PASAFT (DRL PASAFT) PASAFT(DRL PASAFT) 
TSSK TSSK 


ROUTINE RETURNS 


Return is to RETSBS. 


POSTCALLING SEQUENCE 


None. 


SUPPORTING INFORMATION 


Programming Method 


PASAFT is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Let Slave Program Enter Master Mode FEMM (EP10 of .MFALT) 
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TERMTP (DRL TERMTP) TERMTP (DRL TERMTP) 
TSSK TSSK 


TERMINAL TYPE 


TERMTP (DRL TERMTP, TSSK) returns the terminal ID and type code to _ the 


calling routine. 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


TERMTP is called from any TSS subsystem through EXDRL via; 


8 16 
| DRL ‘'TERMTP 
Return 


| i 
OPERATING SYSTEM INTERACTION 
No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to RETSBS. 


POSTCALLING SEQUENCE 


A register contains (in BCl): 


0-17 - Zero 

18-23 - Terminal type code 
(1-3 undefined, 4 TTY) 

24-35 - Terminal ID 
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TERMTP (DRL TERMTP) TERMTP (DRL TERMTP) 
TSSK TSSK 


SUPPORTING INFORMATION 


Programming Method 


TERMTP is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


None. 
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PDIO(DRL PDIO) PDIO(DRL PDIO) 
TSSK TSSK 


PRIVILEGED DISC I/O 


are 


Files allocated directly to time-sharing Executive appear only in the 
-TCFIL table. In general, these system files are accessed only from 
within the Executive portion of the system. However, some of the 
executive functions of the system are performed by privileged subsystem 
programs and it is necessary for these subsystems to have access’ to 
system files. This is done through PDIO. 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


POLO 7S called trom anv nmriviteread TOG euhesvrctam thyareh FY 


SEEK command 


ZERO ;L(file ID), L(DCW1) 
READ/WRITE command 

ZERO iL(file ID), L(DCW2) 
ZERO 1L(status) ,0 


where file ID is a 2-character BCI filename, right-justified with 
leading zeros. Other parameters are defined in DRLDIO. 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 
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PDIO(DRL PDIO) 
TSSK 


ROUTINE RETURNS 


POSTCALLING SEQUENCE 


None. 


SUPPORTING INFORMATION 


Programming Method 
PDIO is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


None. 


154 


GECOS 


Ili SMD TSS EXECUTIVE 


PDIO(DRL PDIO) 
TSSK 
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RESTOR(DRL RESTOR) RESTOR(DRL RESTOR) 
TSSK TSSK 


OVERLAY - LOAD A SUBSYSTEM OR PERM FILE 


RESTOR (DRL RESTOR, TSSK) loads a subsystem or part or all of the 
contents of a permanent file as an extension or an overlay of the 
calling subsystem. When the initial load address is nonzero, it is 
loaded at LOC. This allows loading of floatable libraries, etc., without 
having to provide space for the data area, 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


RESTOR is called from any TSS subsystem through EXDRL via: 


8 16 


1 ORL IRESTOR (subsvetem name) 

ASCII l1, filename 

ZERO jbocation at which to load (LOC), zero or 
initial load location of subsystem 

ZERO jLocation of next instruction, zero 

Return | 


}RESTOR (PERM file) 


ZERO IName pointer, 0 or 1* 
ZERO lnocation at which to load (LOC), zero or 
initial load location of PERM file 
ZERO ILocation of next instruction, location of buffer 


*0 indicates file name = program name (i.e., only one program on_ the 
perm file); buffer = 40 words on a DSU204, 64 words on other mass 
storage devices. 


1 indicates the name pointer designates three words -- a 1-8 character 


ASCII name in the first two words and a 1-6 character BCD program 
name in the third word; buffer = 64 words. 
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RESTOR(DRL RESTOR) 
TSSK 


OPERATING SYSTEM INTERACTION 


No gates are used. 


ROUTINE RETURNS 


Return is to LINSRV. 


POSTCALLING SEQUENCE 


None. 


SUPPORTING INFORMATION 


Programming Method 


RESTOR is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Print Error Message PNTERR (EP1 of TSSG) 
MME GEINOS Processor INOS (EP5 of .MIOS) 
System Error ERROR (EP1 of TSSF) 

Update Allocator Queue ALLOC (EP1 of TSSL) 
End Courtesy Call ENCC (EP5 of .MDISP) 
Special Entry PNTTSX (EP2 of TSSG) 

Search the AFT SRCH (EP8 of TSSK) 
Executive Disc I/O TSXDIO (EP3 of TSSK) 
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III SMD TSS EXECUTIVE 


RESTOR(DRL RESTOR) 
TSSK 


GECOS III SMD TSS EXECUTIVE 


PASFIL(DRL SPAWN) PASFIL(DRL SPAWN) 
TSSK TSSK 


PASS FILE TO BATCH PROCESSOR 


PASFIL (DRL SPAWN, TSSK) generates the information required by GEIN_ to 
process this job. 


PRECALLING SEQUENCE 


Prior to entering PASFIL, the registers listed must contain the data 
indicated. 


A = 0, Immediate return to subsystem 
1, Return after batch job complete 
QU Filename pointer 


CALLING SEQUENCE 


8 16 
{ — : T 
DRL ISPAWN 
ZERO }SNUMB pointer, buffer pointer 


Return 


OPERATING SYSTEM INTERACTION 
No .STEMP storage is used. 


The .CRLAL gate is closed while searching the .CRSNB table for duplicate 
SNUMB and program number. It is opened before relinquishing. The .CRPOQ 
gate is shut while testing and resetting tally. 


ROUTINE RETURNS 


Return is to LINSRV. 
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PASFIL(DRL SPAWN) PASFIL(DRL SPAWN) 
TSSK TSSK 


POSTCALLING SEQUENCE 


QU contains error codes as follows: 


No error 

Undefined file 

No PAT for PASFIL 

Duplicate SNUMB, resubmit with new SNUMB 
SNUMB not given 

No program number available, try again 


Ue WNHO 
uuneu nd wou 


SUPPORTING INFORMATION 


The calling subsystem has written the file as a stacker input job deck 
on a linked file, the name of which is pointed to by QU. Tne file must 
have an empty 320-word first block. The input deck (beginning with the 
second block numbered "1") must have SNUMB and ENDJOB records as in a 
normal input deck. The file is in BCI format. 


The SNUMB pointer specifies the location of the SNUMB obtained via DRL 
SNUMB. The buffer pointer points to a 325-word work area provided by the 
subsystem. PASFIL generates the information required by GEIN in this 
area and writes it into the 320-word first block of the files. 


Upon return to the subsystem, any error condition is indicated by 
one-character BCI error code, right-justified in QU. 


Programming Method 


PASFIL is nonreentrant and relocatable. 


Interrupts are inhibited during master mode processing. 


Storage 


No internal temporary storage is used. 
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PASFIL(DRL SPAWN) PASFIL(DRL SPAWN) 
TSSK TSSK 


Other Routines Used 


Update Aliocator Queue ALLOC (EP3 of TSSD) 

Return to Subsystem from Derail RETSBS (EP2 of TSSK) 
Executive Disc I/O TSXDIO (EP3 of TSSK) 

Search the AFT SRCH (EP8 of TSSK) 

File Spacing TSXSPF (EP7 of TSSK) 


Line Service LINSRV (EP1 of TSSJ) 

Let Slave Program Enter Master Mode FEMM (EP10 of .MFALT) 
Relinguish RLC (EP4 of .MDISP) 

Enable Program ENB (EP6 of .HDISP) 

End Courtesy Call ENCC (EP5 of .MDISP) 

Obtain Normal Snapshot GESNIP (EP1 of .MSNP1) 

Delinking a File FREE (EP3 of TSSD) 
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DRLPPT (DRL TAPEIN) DRLPPT(DRL TAPEIN) 
TSSK TSSK 


PAPER TAPE INPUT 


DRLPPT (DRL TAPEIN, TSSK) starts paper tape input from a teletypewriter. 
The TSS Executive builds the input onto the TAP* file. 


PRECALLING SEQUENCE 


Prior to entering DRLPPT, the registers listed must contain the data 
indicated. 


A File description of TAP* file 


CALLING SEQUENCE 


DRLPPT is called from any TSS subsystem through EXDRL via: 


8 16 
| 
DRL |TAPEIN 
ZERO jL(tally) ,L(Char) (same as DRLKOT) 


Return ! 


OPERATING SYSTEM INTERACTION 
No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to LINSRV. 
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DRLPPT (DRL TAPEIN) 
TSSK 


POSTCALLING SEQUENCE 


None. 


SUPPORTING INFORMATION 


Programming Method 


DRLPPT is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Print Error Message PNTERR (EP1 of TSSG) 
Search the AFT SRCH (EP8 of TSSK) 


GECOS III SMD TSS EXECUTIVE 


DRLPPT(DRL TAPEIN) 
TSSK 
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GECOS III SMD TSS EXECUTIVE 


CALLSS (DRL CALLSS) CALLSS (DRL CALLSS) 
TSSK TSSK 


INTERNAL CALL TO ANOTHER SUBSYSTEM 


CALLSS (DRL CALLSS, TSSK) swaps the calling subsystem to the swap file, 
to be resumed later when a POPUP primitive of the called subsystem is 
executed. A pushdown list of internally-called subsystems is a part of 
each UST. Information required to reload and resume processing of the 
calling subsystem is stored in 2-word entries. Internal calls may be no 
more than 3 deep. (The internal-call pushdown list is distinct from the 
program stack, also in the UST.) 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


CALLSS is called from any TSS subsystem through EXDRL via: 


8 16 

DRL |CALLSS 

ASCII aamene of subsystem to be called 
: | 

Return 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to LINSRV. 
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CALLSS (DRL CALLSS) 
TSSK 


POSTCALLING SEQUENCE 


Programming Method 


CALLSS is nonreentrant 


and relocatable. 


Interrupts are not inhibited. 


Storage 


No internal temporary 


Other Routines Used 


storage is used. 


Update Allocator Queue ALLOC (EP1 of TSSL) 
Print Error Message PNTERR (EP1 of TSSG) 
TSS Subsystem Startup STARTP (EP5 of TSSI) 


GECOS 


ITI SMD TSS EXECUTIVE 


CALLSS (DRL CALLSS) 
TSSK 
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USERID(DRL USERID) USERID (DRL USERID) 
TSSK TSSK 


USER IDENTIFICATION 


USERID (DRL USERID, TSSK) stores the information supplied by the 
terminal user during log-on into the UST and increments the return 
address by one. If the information is incorrect, an error message is 
sent to the terminal. The eighth word of the user's SMC is also _ picked 
through a pointer and stored in .LACPT of the UST. 


PRECALLING SEQUENCE 


Prior to entering USERID, the registers listed must contain the data 
indicated. 


AQ User ID in BCI 
x0 0-5 Priority 
6-17 Disc address 


CALLING SEQUENCE 


USERID is called from the NEW subsystem during the HELLO sequence via: 


8 16 

DRL |USERID 

ZERO j}Pointer to word 7 of SMC, 0 
: | 
- | 

Return | 


Where: 


Word 7 of the system master catalog is used to specify legal 
CARDIN and LODX users and a batch job urgency for CARDIN. 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 
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USERID(DRL USERID) 
TSSK 


ROUTINE RETURNS 


Return is to RETSBS. 


Word 7 of SMC is stored in .LACPT of UST. 


SUPPORTING INFORMATION 


Programming Method 


USERID is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Print Error Message PNTERR (EP1 of TSSG) 


III SMD TSS EXECUTIVE 


USERID(DRL USERID) 
TSSK 
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TERMPG (DRL TERMPG) TERMPG (DRL TERMPG) 
TSSK TSSK 


USER TERMINATE 


TERMPG (DRL TERMPG, TSSK) resets the UST to its initial condition. It is 
normally called only from the TERM subsystem. If another subsystem does 
call, the derail is accepted but the terminate function is bypassed and 
no message is issued. LINSRV performs no more I/O to the designated 
line. 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


TERMPG is called from the TERM subsystem via: 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to RETSBS. 


POSTCALLING SEQUENCE 


None. 
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TERMPG (DRL TERMPG) 
TSSK 


SUPPORTING INFORMATION 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Release Buffer TERM76 (TSSO) 

kKelease UST RUST (EP3 of TSSN) 

Line Service LINSRV (EP1 of TSSJ) 
Yerminate KOUTINEG TERM (BRI OF ‘TSo1L) 


GECOS III SMD TSS EXECUTIVE 


TERMPG (DRL TERMPG) 


Clear UST and Make Accounting Entry TRMCU (EP2 of TSSI) 


TSSK 
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PASUST(DRL PASUST) PASUST(DRL PASUST) 


TSSK 


PASS UST TO SUBSYSTEM 


PASUST (DRL PASUST, TSSK) copies the designated UST to the 
provided by the subsystem. 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


PASUST is called from any TSS subsystem through EXDRL via: 


8 16 

DRL |PASUST 

ZERO lLu(buffer) , number of words to pass 
= | 

Return 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to RETSBS. 


POSTCALLING SEQUENCE 


None. 
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buffer 


GECOS 


PASUST (DRL PASUST) 
TSSK 


Programming Method 


PASUST is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


None. 


III SMD TSS EXECUTIVE 


PASUST(DRL PASUST) 
TSSK 
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GECOS III SMD TSS EXECUTIVE 


MORLNK (DRL MORLNK) MHORLNK (DRL MORLNK) 
TSSK TSSK 


ADD LINKS TO TEMPORARY FILE 


MORLNK (DRL MORLNK, TSSK) acquires the additional number of links 
requested, if possible, and updates the PAT entry for the file. 


PRECALLING SEQUENCE 


Bits 0-5 of LINKS will be masked before the request for more space is 
processed. 


CALLING SEQUENCE 


MORLNK is called from any TSS module through EXDRL via: 


8 16 


DRL |MORLNK 


ZERO jL (LINKS) ,L(fileID) 
Return |! 


| 
where 
LINKS 0-17 - Number of additional links requested 
18-35 - On return, number of links obtained 
file ID - 2-word filename in ASCII 
OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to RETSBS. 
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MORLNK (DRL MORLNK) 
TSSK 


POSTCALLING SEQUENCE 


LINKS 0-5 contain al in the corresponding bit position if 
following errors occur: 
- PAT full 
- Space exhausted 
PERM file 


- File not in AFT 
- No links requested 
- Not used 


OB WN FE O 
I 


SUPPORTING INFORMATION 


Programming Method 


MURLNA LS DONLeeCNTCLaNnt ana LeiocCdatabie. 


Interrupts are not inhibited. 


Storage 


Internal temporary storage is used for buffer. 


Other Routines Used 


Search the AFT SRCH (EP8 of TSSK) 

File Entry Space Allocation PATMAN (EP1 of TSSD) 
Delinking a File FREE (EP3 of TSSD) 

Additional Mass Storage Request MINK (EP2 of .MMORE) 

Let Slave Program Enter Master Mode FEMM (EP10 of .MFALT) 


ie) 


M 


MORLNK (DRL MORLNK) 


TSSK 
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NEWUSR(DRL NEWUSR) NEWUSR(DRL NEWUSR) 
TSSK TSSK 


LOG-ON NEW USER WITHOUT DISCONNECT 


NEWUSR (DRL NEWUSR, TSSK) allows one user to log off and another to log 
on without disconnecting the terminal. The accounting functions are 
performed for the first user, the UST reinitialized and time reset for 
the new user. If the calling subsystem is not NEWU, the call is ignored. 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


NEWUSR is called from the NEWU subsystem via: 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to RETSBS. 


POSTCALLING SEQUENCE 


None. 
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NEWUSR(DRL NEWUSR) 
TSSK 


SUPPORTING INFORMATION 


Programming Method 
NEWUSR is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Reset Flags and Indicators NEWU76 (TSSO) 
Line Service LINSRV (EP1l of TSSJ) 


Terminate Routine TERM (EP1 of TSST) 


System Message Generator SYS (EP4 of TSSI) 


GECOS 
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NEWUSR(DRL NEWUSR) 
TSSK 


Clear UST and Make Accounting Entry TRMCU (EP2 of TSSI) 
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FILACT (DRL FILACT) FILACT(DRL FILACT) 
TSSK TSSK 


PERMANENT FILE REQUESTS 


FILACT (DRL FILACT, TSSK) processes all permanent file requests with the 
exception of file deaccess, which is handled by DRLRFL. The particular 
function requested is specified in the upper half of word 3 of the 
calling sequence. It also allows the master subsystem to purge another 
user's files for the delete SMC usage. 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


FILACT is called from any TSS subsystem through EXDRL via: 


8 16 


DRL IPTLACT 

ZERO lalternate name, L(arglist) 
ZERO Function number, L(buffer) 
Return | 


8 16 
| 
DRL IFILACT 
ZERO IPointer, L(arglist) 
ZERO Function number, L(buffer) 
Return | 


where: 


Entries not required for a function must be 0. 


Alternate name - Two-word entry used when a file is to be accessed 
by a file name other than that by which it was created (e.g., 
a file created in the batch environment with a name of more 
than 8 characters, or a file whose name is the same as_ one 
already in the user's AFT). Note: When an alternate name is 
used, the defined file name in the catalog/file description 
must be in BCI and the alternate name in ASCII. (Used by 
functions 4 and 5.) 
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FILACT(DRL FILACT) FILACT(DRL FILACT) 
TSSK TSSK 
Pointer Pointer to the user-id of the user being deleted by the 


wh 7 t Mm 


14] 
E 
0] 
het 
WY 


ZERO L({status),L(random flag) 
ZERO L(Cat/File Description),, L(permissions) 
Zero L(options), L(new name) 


Used by functions as follows: 
Status (two words) - All 


Random flag - 4 and 5 
Cat/File Description (n words) - All 


Permissions (l word) - 2, 3, 4, 10 and 11 
Options (n words) - 2, 3, 10 and il 
New name (4 words) - 10 and ll 


Function numbers 


1 - System master catalog entry create 
2- Create catalog 

3 - Create file 

4 - Access file and set busy 

5 - Access fiie and do not set busv 

8 - Purge catalog 

9 - Purge file 

10 - Modify catalog 

ll - Modify file 


12 - System master catalog entry delete 

13 - System master catalog entry update 

14 - System master catalog entry query 

15 - System master catalog entry query and set busy 
22 - Release File 


Function numbers 16-21 require the following arglist: 


ZERO L(status) ,L (record) * 
Zero L(Cat/File Description), device name* 
*Filled by file system 


16 - Get first master 
17 - Get next master 
18 - Get current 

19 - Get first 

20 - Get next 

21- Get specific 


Buffer - 380 words 


This buffer is required by all functions. The first 25 words 
are used by the derail processor to build and execute the 
calling sequence to the GECOS File System. The remaining 355 
words are used by the GECOS File System. 
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FILACT (DRL FILACT) FILACT(DRL FILACT) 
TSSK TSSK 


OPERATING SYSTEM INTERACTION 


No gates are used. 


ROUTINE RETURNS 


Return is to calling routine. 


POSTCALLING SEQUENCE 


None. 


SUPPORTING INFORMATION 


An ACCESS on a file that is already open makes a permission check. When 
an attempt is made to write or read a file without proper permission, a 
status of 4037 (octal) is returned to the user which says that the file 
is already open, without regard to the new permissions being asked for. 


On any access of an already open file, the new permissions being asked 
for must be equal to, or a subset of, those already granted on the open 
file. If the permissions are not equal to or a subset, a permissions 
denied or status 4003 (octal) is returned. 

For example, if a file is open with READ only permission, a subsequent 
request for ACCESS with EXECUTE only specified will result in a_ status 
4037, file already open. 

If a file is open with EXECUTE only permission, a subsequent request for 


ACCESS with READ permission specified will result in a status 4003, 
permission denied. 


Programming Method 


FILACT is nonreentrant and relocatable. 


Interrupts are not inhibited. 
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FILACT (DRL FILACT) FILACT(DRL FILACT) 
TSSK TSSK 
Storage 


Internal temporary storage is used for the buffer. 


Other Routines Used 


Disc I/O Derail DRLDIO (DRL DIO, TSSK) 

File Entry Space Allocation PATMAN (EP1 of TSSD) 

Update Allocator Queue ALLOC (EP1 of TSSL) 

Line Service LINSRV (EP1l of TSSJ) 

Let Slave Program Enter Master Mode FEMM (EP10 of .MFALT) 
Print Error Message PNTER (EP1 of TSSG) 

Print Error message PNTERR (EP1 of TSSG) 

End Courtesy Call ENCC (EP5 of .MDISP) 

Search the AFT SRCH (ED8 of TSSK) 

Delinking a File FREE (EP3 of TSSD) 
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SETLNO (DRL SETLNO) SETLNO(DRL SETLNO) 
TSSK TSSK 


SET LINE NUMBER / INCREMENT IN UST 


SETLNO (DRL SETLNO, TSSK) stores the specified line number and increment 
in the User Status Table for use by Line Service. An indicator 
(automatic line numbering mode) and a blank/no blank indicator are set 
in .TFLG2. 


PRECALLING SEQUENCE 


Prior to entering SETLNO, the registers listed must contain the data 
indicated. 


Line number 

increment 

Bit 0 in Q is the blank/no blank indicator 
(0=0=Blank, 
040=No blank) 


© db 


CALLING SEQUENCE 


SETLNO is called from any TSS subsystem through EXDRL via: 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to RETSBS. 
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SETLNO (DRL SETLNO) 
TSSK 


POSTCALLING SEQUENCE 


SUPPORTING INFORMATION 


Programming Method 
SETLNO is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


None. 


ITI SMD TSS EXECUTIVE 


SETLNO (DRL SETLNO) 
TSSK 
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SYSRET(DRL SYSRET) SYSRET (DRL SYSRET) 
TSSK TSSK 


RETURN TO SYSTEM MODE 


SYSRET (DRL SYSRET, TSSK) causes the subsystem to be killed and returns 
to the system selection point, bypassing the normal return via _ the 
primitives. 


PRECALLING SEQUENCE 


Prior to entering SYSRET, the registers listed must contain the data 
indicated. 


A contains a one. 


CALLING SEQUENCE 


SYSRET is called from any TSS subsystem through EXDRL via: 


8 16 
DRL ISYSRET 


Return 


OPERATING SYSTEM INTERACTION 
No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Returns to the system selection point. 


POSTCALLING SEQUENCE 


None. 
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SYSRET (DRL SYSRET) 
TSSK 


SUPPORTING INFORMATION 


Programming Method 


SYSRET is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Update Allocator Queue ALLOC (EP1 of TSSL) 
System Message Generator SYS (EP4 of TSSTI) 
Line Service LINSRV (EP1 of TSSJ) 


Buffer Dump BUFDMP (EP4 of TSSK) 


GECOS 


III SMD TSS EXECUTIVE 


SYSRET(DRL SYSRET) 
TSSK 
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STPSYS (DRL STPSYS) STPSYS (DRL STPSYS) 
TSSK TSSK 


STOP A MASTER SUBSYSTEM 


STPSYS (DRL STPSYS, TSSK) removes a subsystem from the allocator's 
queue. It is used for those master subsystems which set indicators for 
the time-sharing Executive to receive output controlled by the executive 
functions only. 


This derail should not be used by any subsystem which requires’ that 
control be returned and should only be used as a method of turning 
control of a particular remote over to the time-sharing Executive. 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


STPSYS is called from any master TSS subsystem through EXDRL via: 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used, 


ROUTINE RETURNS 


Return is to LINSRV. 
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STPSYS (DRL STPSYS) 
TSSK 


POSTCALLING SEQUENCE 


None. 


SUPPORTING INFORMATION 


Programming Method 


STPSYS is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Other Routines Used 


Update Allocator Queue ALLOC (EP1 of TSSL) 


GECOS III SMD TSS EXECUTIVE 


STPSYS (DRL STPSYS) 
TSSK 
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DRLDSC (DRL DRLDSC) DRLDSC(DRL DRLDSC) 
TSSK TSSK 


DISCONNECT TERMINAL 


DRLDSC (DRL DRLDSC, TSSK) sends any output in the buffer to the terminal 
and, if necessary, sends the disconnect ICM to the DATANET 30. 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


DRLDSC is called from any TSS subsystem through EXDRL via: 


8 16 

| 
DRL {DRLDSC 
Return 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to LINSRV. 


POSTCALLING SEQUENCE 


None. 
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DRLDSC (DRL DRLDSC) DRLDSC(DRL DRLDSC) 
TSSK TSSK 


SUPPORTING INFORMATION 


DRLDSC gives the subsystem the ability to disconnect terminals which are 


not disconnected by receipt of the EOT character (004 ASCII). Any input 
which has been inserted into the line buffer area for the terminal is 
output and upon completion, a MME GEROUT disconnect is issued. The 


Programming Method 


DRLDSC is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Line Service LINSRV (EP1 of TSSJ) 
Update Allocator Queue ALLOC (EP1 of TSSL) 
Buffer Dump BUFDMP (EP4 of TSSK) 
MME GEROUT Processor GROUT (EP1 of .MROUT) 
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PASDES (DRL PASDES) PASDES (DRL PASDES) 
TSSK TSSK 


PASS AFT NAMES AND DESCRIPTIONS 


PASDES (DRL PASDES, TSSK) places the user's available file names and the 
one-word file descriptions in the area specified by the user. 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


PASDES is called from any TSS subsystem through EXDRL via: 


8 16 
| 
DRL |PASDES 
ZERO IL (buffer), 0 
Return 


where 


The maximum size of the buffer is 3 times the number of files in 
the AFT, plus 1 (.LFILES*3+1) 


. LFILES Contains the number of files in AFT 


Chars 5-8 of first file name 
Description of file l 


Chars 1-4 of first file name 
file l 


Chars 1-4 of nth file name 
file n Chars 5-8 of nth file name 
Description of nth file 
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PASDES (DRL PASDES) 
TSSK 


GECOS 


The file description word is formatted: 


| 
Ph 
oa 
a 
iH] 
oat 


19=1 Random 


blocks per file 
file 
file 


20=0 Temporary file 
20=1 Permanent file 


21-23 Unused 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to RETSBS. 


POSTCALLING SEQUENCE 


Q-register contains the 


file description word. 


IIIT SMD TSS EXECUTIVE 


PASDES (DRL PASDES) 
TSSK 
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PASDES (DRL PASDES) PASDES (DRL PASDES) 
TSSK TSSK 


SUPPORTING INFORMATION 


Programming Method 


PASDES is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Let Slave Program Enter Master Mode FEMM (EP10 of .MFALT) 
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GECOS III SMD TSS EXECUTIVE 


JSTS (DRL JSTS) 
TSSK 


GET JOB STATUS 


+y 
vw 


S STs, T 
identified by SNUMB. 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


JSTS is called from any TSS subsystem through EXDRL 


8 16 

| DRL |ISTS 

BCI ji, SNUMB (derail arg. word) 
Return | 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to RETSBS. 


O 
Fh 


via: 


JSTS (DRL JSTS) 
TSSK 


Q 
UJ. 
O 
on 
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GECOS III 


JSTS (DRL JSTS) 
TSSK 


POSTCALLING SEQUENCE 


bits 0-8 Status 

0 = Output ready 

l = Reading - card reader 
2 = Reading - magnetic tape 
3 = Reading - remote terminal 
4 = Waiting - allocation 
5 = Waiting - peripherals 
6 = Waiting - core 

7 = In hold 

8 = In limbo 

9 = Executing 
10 = Swapped out 

ll = Waiting - tape 

i2 = Too: big 
13 = Overdue 
14 = In restart 

15 = Terminating 
16 = Output waiting 
17 = Output complete 

18 = Not in system 

9-17 Activity number 
18-35 SNUMB 


SUPPORTING INFORMATION 


Programming Method 


JSTS is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Let Slave Program Enter Master Mode FEMM (EP10 of 
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SMD TSS EXECUTIVE 


JSTS (DRL JSTS) 
TSSK 


.MFALT) 


GECOS III SMD TSS EXECUTIVE 


CGROUT(DRL CGROUT) CGROUT (DRL CGROUT) 


TSSK TSSK 


PROCESS LINE SWITCH 


switches a 


CGROUT (DRL CGROUT, TSSK) switches a remote terminal line to 
direct-access connection with a slave program (Op=25), or switches any 
line(s) connected to a slave program back to TSS (Op=26), provided such 
lines were originally connected to TSS. 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


CGROUT is called from any TSS subsystem through EXDRL via: 


8 16 
gr ee ee i 7 - 
| DRL 1CGROUT 
| VED (48/0, 0/Up, fies line-1v 
ZERO It. (SNUMB) ,0 
Return | 


If Op=25, line-ID is the station code of line 
to be switched. 


If Op=26, line-ID or zero, which implies all lines. 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to RETSBS. 
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GECOS III SMD TSS EXECUTIVE 


CGROUT (DRL CGROUT) CGROUT (DRL CGROUT) 
TSSK TSSK 


POSTCALLING SEQUENCE 


On return (Op 26), line-ID equals zero if all lines connected to SNUMB 
have been reswitched; if not equal to zero, line-ID is the station code 
of a line still receiving output. 


SUPPORTING INFORMATION 


Programming Method 


CGROUT is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


MME GEROUT Processor GROUT (EP1 of .MROUT) 
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GECOS III SMD TSS EXECUTIVE 


PART(DRL PART) PART(DRL PART) 
TSSK TSSK 


PARTIAL RELEASE OF TEMPORARY FILES 


PART (DRL PART, TSSK) releases a portion of a temporary file. If the 
specified number of links is greater than or equal to the number of 
links in the file, the file is reduced in size to one link. When the 
request has been satisfied, the file is in the rewound position, 


pee eo wee 


POSTCALLING SEQUENCE 


None. 


CALLING SEQUENCE 


PART is called from any TSS subsystem through EXDRL via: 


8 16 

f i 

j i 

DRL [PART 

IZERO be CPG er Se. Cee ae OS a ae eaeeer 
[Return | 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Returns to RETSBS. 
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GECOS III SMD TSS EXECUTIVE 


PART (DRL PART) PART(DRL PART) 
TSSK TSSK 


POSTCALLING SEQUENCE 


A-register contains status as follows: 


AU=0 Request satisfied 
AU=1 File nonexistent or not a temporary file. 


SUPPORTING INFORMATION 


Programming Method 


PART is nonreentrant and relocatable. 


Interrupts are not inhibited. 


storage 


No internal temporary storage is used. 


Other Routines Used 


Search the AFT SRCH (EP8 of TSSK) 
Partial Release of Mass Storage File CALL (EP2 of .MRELS) 
Let Slave Program Enter Master Mode FEMM (EP10 of .MFALT) 
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GECOS III SMD TSS EXECUTIVE 


GROW (DRL GROW) 
TSSK 


INCREASE PERM FILE TO MAXIMUM SIZE 


maarr\ aan mg an a -. 


GROW (DRL GROW, TSSK) increases the size of ar 
permanent file up to its specified maximum file. 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


GROW is called from any TSS subsystem through EXDRL via: 


8 16 
| 
| DRL |GROW 
| ZERO iL(n) ,L(file name) 
| ZERO IL (buffer) ,L(status) 


| Return 


where n may be 


0 to allow the system to determine size of the 


GROW (DRL GROW) 


RE Re ee | 


TSSK 


accessed (open) 


increment, 


the number of 320-word blocks to be added to the file. 


Buffer is a 158-word work area. 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to LINSRV. 


or 
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GECOS III SMD TSS EXECUTIVE 


GROW (DRL GROW) 
TSSK 


POSTCALLING SEQUENCE 


Bits O-1l of the status word may contain: 


4000 No errors 

4002 I/O error - cannot proceed 

4010 Link space exhausted 

4020 Filename illegal 

4024 Internal link table checksum error 


SUPPORTING INFORMATION 


Programming Method 


GROW is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Search the AFT SRCH (EP8 of TSSK) 

Update Allocator Queue ALLOC (EP1 of TSSL) 

Extend Size of TSS File ENT2 (EP2 of .MFSI9) 

End Courtesy Call ENCC (EP5 of .MDISP) 

Let Slave Program Enter Master Mode FEMM (EP10 of 
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.MFALT) 


GROW (DRL GROW) 
TSSK 


GECOS III SMD TSS EXECUTIVE 


ABTJOB (DRL ABTJOB) ABTJOB(DRL ABTJOB) 
TSSK TSSK 


ABORT A JOB 


ABTJOB (DRL ABTJOB, TSSK) aborts the batch job identified by SNUMB and 
submitted from the requesting terminal. 


PRECALLING SEQUENCE 
None. 
CALLING SEQUENCE 


ABTJOB is called from any TSS subsystem through EXDRL via: 


8 16 
I 
| DRL !ABT.JOB 
BCI , 2, SNUMB 
Return i 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to RETSBS. 
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GECOS III SMD TSS EXECUTIVE 


ABTJOB (DRL ABTJOB) ABTJOB (DRL ABTJOB) 
TSSK TSSK 


POSTCALLING SEQUENCE 


0 = Job not in system 

1 = Job not initiated from requesting terminal 
(not your job) 

2 = Abort initiated 


SUPPORTING INFORMATION 


Programming Method 


ABTJOB iS nonreentrant and relocatable. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Let Slave Program Enter Master Mode FEMM (EP10 of .MFALT) 
Process KILL Typein KILL (EP1 of .MPOP1) 
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GECOS III SMD TSS EXECUTIVE 


CONSOL(DRL CONSOL) CONSOL(DRL CONSOL) 


TSSK 


MASTER TTY/600 CONSOLE TALK 


v 


L (DRL CONSOL, T 
ator's console an 


orm sp 
K 
(0) — 
Q 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


CONSOL is called from any TSS master subsystem through EXDRL via: 


8 16 
| 
DRL ICONS OL 
fees ;Output buffer, response indicator 
| ZERO finput buffer 


peeturn | 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


TSSK 


Return is to LINSRV to continue I/O; to RETSBS to return to caller. 


POSTCALLING SEQUENCE 


None. 
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CONSOL(DRL CONSOL) 
TSSK 


SUPPORTING INFORMATION 


Programming Method 


CONSOL is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Disc I/O Derail DRLDIO (TSSK) 

Update Allocator Queue ALLOC (EP1 of TSSL) 
MME GEINOS Processor INOS (EP5 of .MIOS) 
End Courtesy Call ENCC (EP5 of .MDISP) 
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GECOS III SMD TSS EXECUTIVE 


CONSOL(DRL CONSOL) 
TSSK 


GECOS III SMD TSS EXECUTIVE 


DRLSWH (DRL SWITCH) DRLSWH (DRL SWITCH) 
TSSK TSSK 


SWITCH NAMES ASSIGNED TO TEMPORARY FILE SPACE 


H, TSSK) switches the names assigned to two temporary 
tively exchanges the contents of the two files. 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


DRLSWH is called from any TSS subsystem through EXDRL via: 


8 16 

ee lowITcH 

ZERO iL (file name 1),L(file name 2) 
Return i 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to RETSBS. 


POSTCALLING SEQUENCE 


A register contains error return, if any: 


File not open 
File not temporary 


ro 
Hou 
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GECOS III SMD TSS EXECUTIVE 


DRLSWH (DRL SWITCH) DRLSWH (DRL SWITCH) 
TSSK TSSK 


SUPPORTING INFORMATION 


Programming Method 


DRLSWH is nonreentrant and relocatable. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Search the AFT SRCH (EP8 of TSSK) 
Let Slave Program Enter Master Mode FEMM (EP10 of .MFALT) 
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GECOS III SMD TSS EXECUTIVE 


DRLIMT (DRL DRLIMT) DRLIMNT (DRL DRLIMT) 
TSSK TSSK 


TIME AND SIZE LIMIT 


DRLIMT (DRL DRLIMT, TSSK) stores the time and size limits in the UST. 


PRECALLING SEQUENCE 


Prior to entering DRLIMT, the registers listed must contain the data 


indicated. 


A - Time limit 


CALLING SEQUENCE 


DRLIMT is called from any TSS subsystem through EXDRL via: 


8 16 

f i 

DRL IDRLIMT 
Return 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to RETSBS. 


POSTCALLING SEQUENCE 


None. 


GECOS III SMD TSS EXECUTIVE 


DRLIMT (DRL DRLIMT) DRLIMT(DRL DRLIMT) 
TSSK TSSK 


SUPPORTING INFORMATION 


Programming Method 


DRLIMT is nonreentrant. 


Interrupts are not inhibited. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


None. 
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GECOS III SMD TSS EXECUTIVE 


JOUT(DRL JOUT) JOUT (DRL JOUT) 
TSSK TSSK 


BATCH OUTPUT REQUEST 


JOUT (DRL JOUT) is a privileged derail which can be executed only by the 
JOUT subsystem. It provides an interface with .MGEOT and allocates, 
deallocates and updates PAT bodies for the requesting JOUT subsystem. 


PRECALLING SEQUENCE 


Prior to entering JOUT, the registers listed must contain the data 
indicated. 


X2 UST address 
X4 TSS relative arglist 
X3 DRL location 


CALLING SEQUENCE 


TAUIT 346 ecaAlled from the TOUT subsvstem through EXDRI. via: 


DRL lJOUT 

ZERO JOPCODE , ARGLIST 
ZERO —- STATUS , 0 
Return | 


The arglist is dependent on the op code as follows: 


Op Code Arg List 


01 - Get SNUML Entry 
BCI 1,SNUMB 
ZERO 0,0 
ZERO 0,16 


02 - Assign a PAT Body 
ZERO 0,0 


03 - Update PAT (Regular) 


ZERO Offset to PAT Body, File Code 
ZERO SYSOUT Link#, Device 
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GECOS III SMD TSS EXECUTIVE 


JOUT(DRL JOUT) JOUT(DRL JOUT) 


TSSK 


04 - Print at Central Site 
05 - Direct Output to Remote 
06 - Flush Output 


N72 em Noarmrnnca + 4 
07 - Deaccess Output 


(Directives to SYSOUT to manipulate output) 
08 - Deallocate PAT 


09 - Update PAT (Special) 
ZERO Offset to PAT pointer, File Code 
ZERO SCT, Absolute Link # 


OPERATING SYSTEM INTERACTION 
No .STEMP storage is used. 


The .CRSYQ gate is used for communication with GEOT. 


ROUTINE RETURNS 


8 16 


I 
TSX1 |RETSBS 


POSTCALLING SEQUENCE 


None. 


SUPPORTING INFORMATION 


Programming Method 
JOUT is reentrant and written in floatable code. 


Interrupts are inhibited while assigning a PAT body and 
registers. 
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TSSK 


storing 


GECOS III SMD TSS EXECUTIVE 


JOUT(DRL JOUT) JOUT(DRL JOUT) 
TSSK TSSK 
Storage 


Internal temporary storage is used for saving registers during the call 
to .MDISP. 


Other Routines Used 


Update Allocator Queue ALLOC (EP1 of TSSL) 

Line Service LINSRV (EP1 of TSSJ) 

Return to Subsystem from Derail RETSBS (EP2 of TSSK) 
Print Error Message PNTERR (EP1 of TSSG) 

Enable Program ENB (EP6 of .MDISP) 
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GECOS III SMD TSS EXECUTIVE 


OUTNOW (DRL KOTNOW) OUTNOW (DRL KOTNOW) 
TSSK TSSK 


KEYBOARD OUTPUT FROM UNFILLED BUFFER 


OUTNOW (DRL KOTNOW, TSSK) forces output of a partially full buffer. It 
differs from DRL KOUT in that short, intermittent messages from a 
subsystem are not stacked up waiting for the buffer to fill. KOTNOW 
retains control until the buffer is flushed. 


PRECALLING SEQUENCE 


Prior to entering OUTNOW, the A-register will contain the indicator if 
entry is from DRLKON. 


CALLING SEQUENCE 


OUTNOW is called from any TSS subsystem through EXDRL via: 


DRL | KOTNOW 
ZERO j;L(tally) ,L (char) 
Return | 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to LINSRV. 


POSTCALLING SEQUENCE 


None. 


208 


GECOS III SMD TSS EXECUTIVE 


OUTNOW (DRL KOTNOW) OUTNOW (DRL KOTNOW) 
TSSK TSSK 


SUPPORTING INFORMATION 


The field L(tally) points to a driver tally word pointing in turn to a 
list of line TALLYB words which define each line of output ASCII 
characters to be sent to the keyboard. The driver tally has the count of 
the line tallies in the list. This allows the user to define scattered 
lines, not necessarily starting at word boundaries. The derail processor 
utilizes the tally words and they may be modified on return to the 


subsystem. 


The optional field L(char) points to a word containing up to _ four 
characters that will be appended to the end of the output defined by 
each line tally. These characters could be line feed, carriage return, 
etc. If this field is not present in the calling sequence, no characters 
will be added. If the field is present, the first zero character 
terminates the appending of characters. In any case, no more than four 
characters will be appended. Note: Because of timing considerations and 
character set differences between terminal types, the carriage return 
characters should always precede the line feed character and one or two 
delete characters. 


Programming Method 


OUTNOW is nonreentrant. 


Interrupts are inhibited during output. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Set Tally for Output Buffer STBTAL (EP5 of TSSK) 
Return to Subsystem from Derail RETSBS (EP2 of TSSK) 
Line Service LINSRV (EP1 of TSSJ) 

Transmit Data to Buffer STOBUF (EP6 of TSSK) 

Update Allocator Queue ALLOC (EP1 of TSSL) 

Pass AFT to Subsystem PASAFT (DRL PASAFT, TSSK) 
Paper Tape Courtesy Call PPTCCl (TSSJ) 
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GECOS III SMD TSS EXECUTIVE 


OBJTIM(DRL OBJTIM) OBJTIM(DRL OBJTIM) 
TSSK TSSK 


PROCESSOR TIME AND CORE SIZE LIMIT 


OBJTIM (DRL OBJTIM) sets bit 6 of the .LSWTH of the user's UST so that 
core size limit and processor time limit are checked. 


CALLING SEQUENCE 


OBJTIM is called from any TSS subsystem through EXDRL via: 


8 16 


DRL lOBJTIM 


Return 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to RETSBS. 


POSTCALLING SEQUENCE 


None. 


210 


GECOS III SMD TSS EXECUTIVE 


OBJTIM(DRL OBJTIM) OBJTIM(DRL OBJTIM) 


TSSK 


TSSK 


SUPPORTING INFORMATION 


Setting Limits 

a. installation core size and processor time limits are 
assembled or patched into words .TASSZ and .TSTM of MTSSA. 
The core size is put in .TASSZ in number of words. The time 
limit is put in .TASTM in pulses (number of seconds 
*64*1000). 


b. User-specified processor time limit is set by the BASIC and 
FORTRAN subsystems according to the user directive on the 
RUN command line. The user types: 


RUN-nn 


where nn is the object run time limit the user wishes in 
seconds. BASIC and FORTRAN place this time limit (in 
seconds) in the A-register and do a DRL DRLIMT. The derail 
processor converts this to pulses and places it in .LIMIT 
of the user's User Status Table. 


Notifying the Time Sharing Executive that it is Generated Code 
Now Beina Executed: 


The BASIC and FORTRAN compilers will generate, as the first 
instruction of the user program, a DRL OBJTIM. This derail sets 
bit 6 of .LSWTH of the user's UST. Unless this bit is set, 
neither core size limit nor processor time limit will be 
checked. 


Checking Limits 

a. Processor Time Limits 
TSSM, if bit 14 of .LSWTH of the UST is on, sets a timer 
(.LIMTR in the UST), with the smaller of .TASTM 
(installation time limit) or .LIMIT (user time limit). Each 
time through TSSM, the timer (.LIMTR) is then decremented 
until it runs out or until the interaction ends. 


b. Core Size Limit 


The core size limit is checked in TSSL at two different 
times if bit 6 of .LSWTH is on. 


1) At the time of the DRL OBJTIM to see that the size is 
not already too big and 


2) At the time of an ADDMEM request by the subsystem. 
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GECOS III SMD TSS EXECUTIVE 


OBJTIM(DRL OBJTIM) OBJTIM(DRL OBJTIM) 


TSSK 


4. Return 


TSSK 


When either size or time limits are exceeded, word 1l (decimal) 


of the subsystem prefix is checked for a fault vector. 


If word 


11 contains a valid fault vector, the return to the subsystem 


is through this word. The IC and I where the fault occurred 
stored in word 10 with bit 34 set for size limit exceeded 


bit 35 set for time limit exceeded. 


Time-sharing will type the appropriate one of two messages 


there is no fault vector and return to the user at 
level. These messages are: 


064 - EXECUTE TIME LIMIT EXCEEDED 
and 
065 - OBJECT PROGRAM SIZE LIMIT EXCEEDED 


is 
and 


mg 


system 


5. Resetting the user specified time limit, the timer (.LIMTR), 
and the generated code bit in .LSWTH: 


These will be reset in TSSH or TSSL at the end 
interaction. 


Programming Method 


OBJTIM is nonreentrant. 


Interrupts are not inhibited. 


storage 


No internal storage is used. 


Other Routines Used 


Core Size Adjustment ALL7AC (EP3 of TSSL) 
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GECOS III SMD TSS EXECUTIVE 


PASFLR(DRL PASFLR) PASFLR(DRL PASFLR) 
TSSK TSSK 


PASS FILE TO REMOTE BATCH PROCESSOR 


Pal oie ok i 


PASFLR (DRL PASFLR) generates the information required by GEIN to 
process this job. It performs the same functions as DRL PASFIL for jobs 
designated REMOTE. 


CALLING SEQUENCE 


PASFLR is called from any TSS subsystem through EXDRL via: 


8 16 
DRL IPASFLR 
Return 


For further details, see DRL PASFIL. 
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GECOS III SMD TSS EXECUTIVE 


PPTOFF/PPTERM (DRL STOPPT) PPTOFF/PPTERM (DRL STOPPT) 
TSSK TSSK 


SEND "STOP PAPER TAPE" TO DATANET 


PPTOFF/PPTERM (DRL STOPPT) sends the command, Stop Paper Tape Input, to 
the DATANET 355 prior to sending an error message to the remote 
terminal. There are two entry points, one from the TSS Executive and one 
from a subsystem. 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


PPTOFF is called from the Executive via: 


8 16 
| 
TSX1 |PPTOFF 
Return (If tape running) 
e | e 
Return (re tape not running) 


PPTERM is called from any TSS subsystem through EXDRL via: 


8 16 
DRL ISTOPPT 
Return 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 
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GECOS III SMD TSS EXECUTIVE 


PPTOFF/PPTERM(DRL STOPPT) PPTOFF/PPTERM (DRL STOPPT) 
TSSK TSSK 


ROUTINE RETURNS 


8 16 
| | 

TSX1 IRETSBS (If no tape running) 
MME IGEENDC (If tape was running) 


POSTCALLING SEQUENCE 


None. 


SUPPORTING INFORMATION 


Programming Method 
DRL STOPPT is nonreentrant. 


interrupts are not inhibited. 


Storage 


Internal temporary storage is used to store the entry flag. 


Other Routines Used 


MME GEROUT Processor GROUT (EP1 of .MROUT) 
Line Service LINSRV (EP1 of TSSJ) 
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GECOS III SMD TSS EXECUTIVE 


SAVE (DRLSAV) SAVE (DRLSAV) 
TSSK TSSK 


SAVE PROGRAMS ON PERM FILE 


SAVE (DRLSAV) allows any program to be saved on a perm file instead 
of requiring a perm file to be built via a batch activity. A maximum of 
40 files may be contained in a single catalog. 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


SAVE is called from any TSS subsystem through EXDRL via: 


8 16 
l 
DRL | SAVE 
ZERO |Name pointer, 0 or 1* 
ZERO [Initial address of program to be written, 


Final address of program to be written 
jEntry address, load origin 
ZERO Return address, buffer location 


* 0 when first program being written on file. 


l when program is being added to an existing 
file of program(s). 


OPERATING SYSTEM INTERACTION 
No .STEMP storage is used. 


No gates are used. 
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GECOS III SMD TSS EXECUTIVE 


SAVE (DRLSAV) SAVE (DRLSAV) 
TSSK TSSK 


ROUTINE RETURNS 


8 16 

(oe ne Bg ge ge 
TRA ha 
TRA | LINSRV 


POSTCALLING SEQUENCE 
A - contains 0 if SAVE successful 


Bit 35 = lin A- File not large enough for requested SAVE. 


SUPPORTING INFORMATION 


gsi vy L nuit ily 2h L1100 


SAVE is nonreentrant and written in floatable code. 


Interrupts are not inhibited. 


Storage 


No internal storage is used. 


Other Routines Used 


Search the AFT SRCH (EP8 of TSSK) 

Update Allocator Queue ALLOC (EP1 of TSSL) 

Executive Disc I/O TSXDIO (EP3 of TSSK) 

Let Slave Program Enter Master Mode FEMM (EP10 of .MFALT) 
End Courtesy Call ENCC (EP5 of .MDISP) 

Print Error Message PNTERR (EP1 of TSSG) 

Special Entry PNTTSX (EP2 of TSSG) 


GECOS III SMD TSS EXECUTIVE 


TASK (DRL TASK) TASK (DRL TASK) 
TSSK TSSK 


SPAWN A SPECIAL BATCH ACTIVITY 


TASK (DRL TASK) provides entry to the batch system at the core 
allocation level. Since peripheral allocation is bypassed, all file 
PAT's must be provided in the SSA information passed via *J. 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


TASK is called from any TSS subsystem through EXDRL via: 


8 16 

LDA \0 »DL 

DRL TASK 

ZERO SSA buffer, location of file list 


Return | 


OPERATING SYSTEM INTERACTION 
The top entry in the stack is the IC and I of the calling routine. 
No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


8 16 


] 
| nsx IRETSBS 


218 


GECOS III SMD TSS EXECUTIVE 


TASK(DRL TASK) TASK (DRL TASK) 
TSSK TSSK 


POSTCALLING SEQUENCE 


A-register contains one of the following return codes: 


No error (DRL) - batch status in Q-register 
Undefined file 
No SNUMB 


Duplicate SNUMB 

No program number available 

Activity name undefined 

Illegal user limits (time, size, etc.) 

Bad status (R/W *J) 

System out of file space for pushdown file 
No *J provided 


WOMAIADU S&WNE CO 


SUPPORTING INFORMATION 


TASK completes the information in the SSA after verifying that provided 
by the user. The PAT's for the designated files are copied to the SSA 
butters The SSA.1s6- then written on the: fives twe losers of Sac. seers 


*J. GEPOP is enabled to enter the job at the core allocation level 


fovoass GEIN, PALC, etc.)}. The calling SSA is nut in wait etatue., GECAS 


will notify TSS when the batch activity is completed. 


‘ ae ae 


Upon return from the GECOS activity, TASK is again entered. The IC and I 
is not modified during the first phase and a unique value is stored in 
the user's A-register to denote the second entry to TASK. The first two 
blocks of *J are read into the user's SSA buffer. This is the SSA _ upon 
completion of the batch activity. The file list designates those file 
PAT's which must be updated in the user's AFT (in case of file grow, 
etc.). The status of the batch activity is returned in Q-register. 


In the event a user "breaks" or "disconnects" his terminal while the 
spawned job is executing, the break or disconnect must be delayed until 
the DRL TASK has completed the second phase. 


Programming Method 


TASK is nonreentrant and written in floatable code. 


Interrupts are not inhibited. 
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GECOS IIT SMD TSS: EXECUTLVE 


TASK (DRL TASK) TASK(DRL TASK) 
TSSK TSSK 
Storage 


No internal storage is used. 


Other Routines Used 


Provide Date and Time of Day FGTIM (EP8 of .MFALT) 
Search the AFT SRCH (EP8 of TSSK) 

Let Slave Program Enter Master Iiode FEMM (EP10 of .MFALT) 
Process Specific Device Request ENTRY (EP1 of .MALC2) 
Executive Disc I/O TSXDIO (EP3 of TSSK) 

Update Allocator Queue ALLOC (EP1 of TSSL) 

Line Service LINSRV (EP1 of TSSJ) 

Relinguish RLC (EP4 of .MDISP) 

Enable Program ENB (EP6 of .MDISP) 

End Courtesy Call ENCC (EP5 of .MDISP) 

File Spacing TSXSPF (EP7 of TSSK) 

Return Links/Liinks to thé Pool ONE (EP1 of .MALC®) 
Delinking a File FREE (EP3 of TSSD) 

File Entry Space Allocation PATMAN (EP1 of TSSD) 
Print Error Message PNTERR (EP1 of TSSG) 
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FAKEIN (DRL PSEUDO) FAKEIN(DRL PSEUDO) 


TSSK 


FAKEIN (DRL PSEUDO, TSSK) allows one subsystem to store data in the 
I/O buffer so the data can be recovered by another subsystem via a 
KIN. The effect is to create a 62-word core file in the UST. 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


FAKEIN is called from any TSS subsystem through EXDRL via: 


8 16 
| DRI IpSEUDO 
' rec eee t & z. ba Ae 

Ob hs ANY prey Geaiver wos ~ULtiaiy fa weuiL UD 
| Return | 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


8 16 


TSX1 'RETSBS 


Error return is to LINSRV. 


POSTCALLING SEQUENCE 


None. 


TSSK 


UST 
DRL 
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FAKEIN (DRL PSEUDO) FAKEIN(DRL PSEUDO) 
TSSK TSSK 


SUPPORTING INFORMATION 


A subsystem "X" would use DRL PSEUDO to pass "input" to a subsystem "yY" 
that would be activated by a DRL CALLSS. Eventually, Y will return to xX, 
and the process may be continued. Subsystem xX thus becomes a ‘user 
surrogate' subsystem with TSS subsystems available to it as a "library." 


No check on the actual data placed in the UST will be made, therefore, 
any type of data may be passed in any form - binary, USASCII, etc. DRL 
KIN also takes no note of the data form. 


The tally is used by the derail processor in transferring the data (in 
9-bit characters) and must therefore be reset prior to each subsequent 
use. 


The status return word is provided for future expansion and will not be 
used in the initial implementation. 


No more than 62 words may be transferred at any time. Each successful 
transfer will overlay information already in the UST since buffer 
loading will begin at the start of the buffer. 


In operation, the sequence of events is as follows -- upon receipt of 
the PSEUDO derail, the derail processor examines the tally to determine 
that (a) the tally is not run out, (b) the tally is not for 6-bit 
characters, (c) the tally is not set to transfer more than 248 
characters (62 words), (d) neither the starting nor ending addresses 
specified by the tally are outside subsystem limits, and that the status 
word is not outside subsystem limits. Should any of these conditions 
occur, the subsystem will be aborted, and an error message sent to the 
remote terminal. 


Once these checks have been successfully completed, the derail processor 
checks to determine whether or not any output remains in the UST buffer 
and flushes any that it finds. When the buffer is cleared of all output, 
the data to be moved is placed in the buffer and the buffer control 
words set up exactly as if the data had come in from a remote terminal. 
Transfer will end when the tally runs out. 


Once all material has been moved, the derail processor returns to the 
second location past the DRL PSEUDO in the calling subsystem. 


This derail is not available to DATANET 760 terminals. 
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FAKEIN (DRL PSEUDO) FAKEIN(DRL PSEUDO) 


TSSK 


SUPPORTING INFORMATION 


Programming Method 


FAKEIN is nonreentrant and written in floatable code 


Interrupts are not inhibited. 


Storage 


Internal temporary storage is used for storing tallies. 


« 


Other Routines Used 


Print Error Message PNTERR (EP1 of TSSG) 
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ALLOCATION AND DISPATCH OF SUBSYSTEI PROGRAMS (TSSL) 


TSSL selects the order of execution for subsystem programs eligible for 
processing, manages the available core and mass storage space, swaps the 
programs into and out of core, and dispatches the processor to _ the 
program, 


TSSL contains four entry points: 


EP1 Update Allocator Queue (ALLOC) 
EP2 Allocate Job in Queue (ALLOCTI) 
EP3 Core Size Adjustment (ALL7AC) 
EP4 Set Up for Swap (SWAP) 


TSSL occupies approximately 3410 (octal) core storage locations. 


A job is allowed a given amount of processor time before it is 
considered eligible for swapping. The assigned time is a function of the 
program size, with a minimum of 200 milliseconds and a maximum of 1 
second. To avoid the overhead required to select a different job each 
time the time-sharing system is interrupted, the processor is returned 
to the "last" job until the given amount of time has accumulated, or an 
I/O request is initiated. 


The Allocator queue is maintained in descending order of priority. The 
current priority value is stored in lower half .LBACK. When a new job is 
entered into the queue, the priority value is infinite since one 
objective is to maximize the rate of user/system interactions with 
emphasis on the first responses for short jobs. Long jobs gradually drop 
down in the queue as times accumulate, but only to a certain point. 


A pass through the allocation queue is made about every 2 seconds to do 
the following for each entry: 


@e Update the priority values and reorder the queue if necessary. 


e Start swap-out if keyboard I/O has been initiated and any bypass 
counts have accumulated. 


e Increment a bypass number. If this number is greater than a 
given bypass count, the urgent user count is incremented and a 
pointer to the most urgent user is kept. 


224 


GECOS III SMD TSS EXECUTIVE 


Check for any urgent users and, if any, calculate average urgency. If 
one most urgent user has an urgency at least twice the average, 


er 


immediate action is taken to load and process that job. 


Make a pass through the Allocator queue for jobs eligible to be 
loaded/swapped into core. Note that jobs which have maximum priority 
will be at the top of the queue and, therefore, will be moved into core 
quickly. As a job is deemed eligible, space will be found in core and 
the load/swap started. As many jobs as will fit are moved into the core 
area. 


The jobs residing in core are checked. If a job has accumulated three 
times the allowed processor time, this job is eligible to be swapped out 
if a job in the Allocator queue is eligible for swap-in. Therefore, the 
Allocator queue is searched for an eligible job which will fit in the 
core space to be made available. If found, swap-out is started with a 
courtesy call to start the swap-in. 


Now the Allocator queue is again scanned to select a job ready for the 
processor and having the least amount of processor time for this job. 
The bypass number is cleared and the UST pointer is saved as "last" job. 


The core Allocator maintains a memory map of the time-sharing system 


ae er mMmAmnY: a= ~ tlw tt. . A 4 31.7 a n . 
é wb baw ey —-- we ae a id weet ew eH wa - ea oi Vast ii Oe 


No. blocks 
word 1 Forward link pointer used 


IA (core Backward 
word 2 location) index UST Pointer 


Core blocks are 1024 words and all IA core(s) are on block boundaries. 
(To facilitate calculations, the "No. Blocks" in core map are two times 
the number of 1024-word blocks. Since base addresses are set for 
subsystems, block boundaries are required. Another word (.TAMPT) 
containing pointers to the initial entry and the last entry of the core 
map must also be maintained. At initialization (TSTART), the initial 
address mod 1024 of time-sharing system core memory will be established 
(.TACOR). (TSTART is last in the deck and is overlayed with time-sharing 
system core memory.) 


When the core allocation routine is called, new/old interaction is 
checked. Search for space for a new job is from the low (address) end of 
core, that is, forward through the map. An old job causes the search to 
start from the high end of the core backward through the map. 
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When space is found, a new entry is made and hole sizes, forward 
pointers, and backward indexes are modified to reflect the change. When 


searching for space, the smallest hole large enough to meet requirements 
is found. 


The core space is cleared (0) before loading. 


There are three possible results (returns) of core allocator routine: 


No core available 
Not enough contiguous core available 


Space found - return IA (core) 
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ALLOC (EP1) ALLOC (EP1) 
TSSL TSSL 


UPDATE ALLOCATOR QUEUE 


j#- 


ALLOC (EP1 of TSSL) updates the Allocator 
status of subsystem programs in execution. 


queue by enterina changes 
bee 5 = at Oe ab ie abical i baat bec) a iaaetio 


The Allocator queue is made of linked UST's which have a job to be 
executed. They are linked both forwards and backwards, with starts and 
ends stored in .TSCOM. The forward link pointer is in the upper half of 
~LFLAG and the backward pointer in .LBACK. 


PRECALLING SEQUENCE 


Prior to entering ALLOC, the registers listed must contain the data 
indicated. 


X2 Pointer to UST 
A Function parameter, as follows: 


0 - Enter a new job (interaction) into the queue. The link 
PY4iiLcLas ALG pluLrecu AlLLU Llic Llicw jVUL aiiu ALLOULCALUL Queue +4Llays 
set "on" in .LFLAG. 


1 - Remove (kill) a job from the queue. After a delay, if in swap 
status, any allocated core space is released. Space on the 
swap file is also released if it exists. The Allocator queue 
pointers are updated to bypass this job and the Allocator 
flags in .LFLAG are cleared. 


2 - Set .LFLAG to indicate start of file I/O. 


3 - Set .LFLAG to indicate file I/O finished. 


4 - Set .LFLAG to indicate start of keyboard I/O. 


5 - Set .LFLAG to indicate keyboard I/O finished. 


6 - Remove the job from core to drum and remove its entry from the 
core map. DRL CALLSS uses this function. 
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ALLOC (EP1) 
TSSL 


Release memory (core space) for the current process according 
to the contents of Q. The Q-register designates the number of 
words low (in upper half) or high (in lower half) to be 
released. The numbers are multiples of 1024. Modifications are 
made in the core map and alli common references to base 
registers, initial address or size. DRL RELMEIi uses’ this 
function. 


‘Extend memory (core space) for the current process according 


to the contents of Q-lower. Memory can be extended only on the 
high end. If contiguous space is not available, the job is 
swapped to the drum. The core map is modified and all common 
references to size are updated. DRL ADDMEM uses this function. 


Set bit 25 on in user's flag word to indicate that Line 
Service should look for a possible disconnect. DRL SPAWN uses 
this function. 


CALLING SEQUENCE 


ALLOC is called from PASFIL, TERM, PATDEA, FREE, SCAN3, TRMCU, UPDAT, 
DRLDIO, CALLSS, SYSRET, RELMEM, ADDMEN, STPSYS, RESTOR, GROW, CONSOL, 
ERROR, DRLRET, DRLKON, DRLKOT, DRLDSC, DRLDIO, FILACT, SAVE, TASK, 
EXENTR, EXTSQ and NEWU76 via: 


OPERATING 


No .STEMP 


8 16 
TSX1 | ALLOC 
Return | 


SYSTEM INTERACTION 


storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is 
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to caller. 


GECOS 


ALLOC(EP1) 
TSSL 


POSTCALLING SEQUENCE 


‘xT 


NOTIC e 


Programming Method 


ALLOC is nonreentrant and relocatable. 


Interrupts are inhibited throughout. 


Other Routines Used 


System Error ERROR (EP1 of TSSF) 

Line Service LINSRV (EP1 of TSSJ) 

Trace Recent Events TSEVNT (EP1 of TSSB) 
Relinguish RLC (EP4 of .MDISP) 

Return Drum Space RETSPC (EP2 of TSSC) 
Set Up For Swap SWAP (EP4 of TSSL) 

End Courtesy Call ENCC (EP5 of .MDISP) 
Print Error Message PNTERR (EP1 of TSSG) 
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ALLOC (EP1) 
TSSL 
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ALLOCI (EP2) ALLOCI (EP2) 
TSSL TSSL 


ALLOCATE JOB IN QUEUE 


ALLOCI (EP2 of TSSL) examines the Allocator queue and selects the job to 
be processed. It controls a program's access to core and processor time 
according to the priority value maintained for each job in the queue. 


PRECALLING SEQUENCE 


Prior to entering ALLOCI, the registers listed must contain the data 
indicated. 


X2 Pointer to UST 


CALLING SEQUENCE 


ALLOCI is called from LINE SERVICE via: 


8 16 
TSX1 ! AT LOCT 
Return '! 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to the calling routine. 


POSTCALLING SEQUENCE 


None. 


230 


GECOS III SMD TSS EXECUTIVE 


ALLOCI (EP2) ALLOCI (EP2) 


TSSL 


SUPPORTING INFORMATION 


Programming HMethod 


ALLOCI is nonreentrant and relocatable. 


Interrupts are inhibited while modifications are made in core 
scanning queue for dispatch, and moving in/out of core. 


No internal temporary storage is used. 


Other Routines Used 


Set Up For Swap SWAP (EP4 of TSSL) 
Core Allocator ALL7AC (EP3 of TSSL) 
Line penvice LINSRV (EP1 of TSSJ) 


ieee beta e a {ac am Crmnaf PBR LISS ae pe eae ~ eee LEG 
3 


eRe MS ft MSE ~reRereod Po erers gel a wi a 


Return to Subsvetem Execution RETSSX (EP 3 of TSS) 


roOMt CETMAS en Pata c frend ee oF eNO 


TSSL 


map , 
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ALL7AC (EP 3) ALL7AC (EP3) 


TSSL 


TSSL 


CORE SIZE ADJUSTMENT 


ALL7AC (EP3 of TSSL) examines the request for TSS core size change from 
the 600 console. 


die 


If core size request is same as current size, returns. 


If the request is for more core, a MME GEMORE is used _ to 
request space. If not available, ALL7AC tries for 20 times at 
3-second intervals before issuing message to 600 console that 
space is not available. 


If the request is for less core, ALL7AC releases the space 
freed up after swapping user's subsystems to swap file. 


PRECALLING SEQUENCE 


Prior to entering ALL7AC, A upper contains the size of core requested. 


CALLING SEQUENCE 


ALL7AC is called from LINSRV via: 


8 16 

| 
TSX1 {| ALL7AC 
Return | 


OPERATING SYSTEL INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to calling routine. 
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ALL7AC (EP3) ALL7AC(EP3) 
TSSL TSSL 


SUPPORTING INFORMATION 


Programming Method 


ALL7AC is nonreentrant and relocatable. 


Interrupts are inhibited while making adjustments in core map. 


Other Routines Used 


MME GEMORE Processor LHLiORE (EP1 of .MMORE) 

MME GEINOS Processor INOS (EP5 of .HIOS) 

Request Drum Space DRMSPC (EP1 of TSSC) 

Set Up for Swap SWAP (EP4 of TSSL) 

Let Slave Program Enter Master Mode FEMM (EP10 of .IIFALT) 
Memory Release for Time-Sharing GMRLM (EP9 of .HMFLT1) 
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SWAP (EP4) SWAP (EP 4) 
TSSL TSSL 


SET UP FOR SWAP 


SWAP (EP4 of TSSL) swaps jobs in and out of core according to their 
priority. 


PRECALLING SEQUENCE 


Prior to entering SWAP, the registers listed must contain the data 
indicated. 


A Read/Write command 
Q Core location, courtesy call location 
X2 UST address 


CALLING SEQUENCE 


SWAP is called from DYUST via: 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


ROUTINE RETURNS 


Return is to calling routine. 


POSTCALLING SEQUENCE 


None. 
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SWAP (EP 4) 
TSSL 


SUPPORTING INFORMATION 


Programming Method 


SWAP is nonreentrant and relocatable. 


Interrupts are inhibited throughout except at MME GEINOS. 


storage 


No internal temporary storage is used. 


Other Routines Used 


Monitor Procedures MONCK (EPG of TSST} 


MME GEROUT Processor GROUT (EP1 of . ROUT) 
MMF GETNOS Processor TNOS (EPS of (TOS) 


System Error ERROR (EP1 of TSSF) 


SWAP (EP 4) 
TSSL 
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EXECUTIVE SUBPROGRAM (TSSM) 


The Executive Subprogram (TSSIi) is the entry from GECOS III for all 
faults while in execution mode and the entry for all faults’ and 
interrupts subsequent to a GELBAR setting in subsystem mode. TSSM also 
contains the common subroutine used to enter a subsystem and the routine 


used by Line Service to process entries in the time-sharing system 
queue. 


TSSM contains three entry points: 


e EPIL Entry From GECOS (EXENTR) 
@ EP2 Process TSS Queue Entries (EXTSQ) 
e EP3 Return to Subsystem Execution (RETSSX or RETSBS) 


pproximately 1220 (octal) core storage locations 
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EXENTR(EP1) EXENTR(EP1) 
TSSM TSSM 


ENTRY FROM GECOS 


EXENTR (EP1 of TSSM) calculates accounting charges, examines the fault 
type, and transfers control as necessary to continue processing. 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


EXENTR is called from .MDISP. 


Normal entry is from GECOS III; the user has no control of entries. 


ODERATING SVSTER TNTFRACTTON 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Control passes - no return: 
EXDRL - process DRL fault (user) 
LINSRV - next task 
MME GELBAR - dispatch 


PNTERR - user fault 
ERROR - fatal user fault 


POSTCALLING SEQUENCE 


None. 
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EXENTR (EP1) EXENTR (EP 1) 
TSSM TSSM 


SUPPORTING INFORMATION 


TSTART stores transfers to EXENTR in the fault vector to handle faults 
occurring in executive mode. These faults are "system" faults; therefore 
an error code is loaded and ERROR called. Control then continues to Line 
Service. 


When a return from a MME GELBAR occurs, control enters EXENTR via the 
instruction stored at decimal location 19 by TSTART. After the registers 
are saved, the information at location 25 is examined to determine the 
type of return. 


Note 


A GELBAR return occurs when a fault, a timer runout, 
or return from interrupt processing occurs when the 
processor is assigned to a subsystem. 


If the return is from I/O interrupt processing, the GELBAR is reissued. 
If from a timer runout, accounting charges are calculated for the user 
and control goes to Line Service. Lockup, op-not-complete and memory 
parity are considered fatal for the user by calling ERROR and returning 
to Line Service. On a DRL fault, the user's accounting charges are 
calculated and control is sent to the derail processor (EXDRL). 


For all other faults, memory, MME, divide check, etc., a test is made to 
determine if the subsystem has a fault vector; i.e., the subsystem is 
prepared to handle the fault. If so, the fault transfer location is 
stored in the IC and I, the fault transfer location is zeroed to prevent 
unintentional looping in the subsystem, and the GELBAR is’ reissued to 
continue execution of the subsystem. If the subsystem did not have a 
fault transfer stored, the user's file list is searched for a file named 
ABRT. If found, the subsystem is dumped to that file. In any case, 
PNTERR is called to issue an error message to the user. 


Programming Method 


EXENTR is nonreentrant and relocatable. 


Interrupts are inhibited while SSA values (times) are being referenced. 
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EXENTR(EP1) 
TSSM 


Line Service LINSRV (EP1 of TSSJ) 

Derail Entry From Executive EXDRL (EP1 of TSSK) 
System Error ERROR (EP1 of TSSF) 

Reset BAR to Smaller Area FLBAR (EP14 of .MFALT) 
Let Slave Program Enter Master Mode FEMM (EP10 of .IMFALT) 
Search the AFT SRCH (EP8 of TSSK) 

Update the Allocator Queue ALLOC (EP1 of TSSL) 
File Spacing TSXSPF (EP7 of TSSK) 

Executive Disc I/O TSXDIO (EP3 of TSSK) 

Print Error Hessage PNTERR (EP1 of TSSG) 

Special Entry PNTTSX (EP2 of TSSG) 

End Courtesy Call ENCC (EP5 of .MDISP) 


EXENTR(EP1) 
TSSM 
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EXTSQ(EP2) EXTSQ (EP2) 
TSSM TSSM 


PROCESS TSS QUEUE ENTRIES 


EXTSQ (EP2 of TSSM) checks the TSS queue for entries from the computer 
console or from GECOS III at termination of a time-sharing batch job. 
The parameters and functions are: 


- Return Batch Job 

- New Users will be Accepted 

- No New Users to be Accepted 

Status Request 

- Change Size of Core 

- Issue Warning Message to All Active Users 

- Request and Issue Message to All Active Users 
- Print Last Message on 600 Console 


OnNDUBWNH EE 
t 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


EXTSQ is called from LINSRV via: 


8 16 
TSX1 lEXTSQ 
Return | 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


The .~.CRTSQ gate is shut while loading the ID and updating the tally. 


ROUTINE RETURNS 


Return is to calling routine. 
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EXTSQ(EP2) EXTSQ(EP2) 
TSSM TSSM 


POSTCALLING SEQUENCE 


None. 


One entry in the queue is processed per interval. The intervals at which 
Line Service checks are frequent enough so that this should be 
sufficient. Changing the TRA at the end of each function could cause all 
entries to be processed. 


NEW, NONEW and STATUS requests simply set indicators which Line Service 
recognizes. Size n stores the requested memory size so that the 
Allocator or Line Service can process. WARN t is put in the 
communications buffer with the given parameter "time" filled in. Flags 
are set for all active and new users to receive the message. 


When a batch job (BATCH) is returned by GECOS, the UST must be found by 
means of SNUMB and the ABORTCODE stored. Then the user must be entered 


back in the allocation queue. 


When the computer operator types NESS and the entry in the queue is 
processed, a request for the operator to type a message is issued: *TSS 
MESS--. When the operator has typed the message, it is converted to an 
ASCII comment and output to all current users as well as users who 
subsequently dial into the system. 


When the computer operator types TSS LAST, the ASCII all points message 
is converted to BCI and output to the 600 console. 


Programming Method 


EXTSO is nonreentrant and relocatable. 


Interrupts are inhibited while opening/shutting .CRTSQ gate. 


Storage 


No internal temporary storage is used. 
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EXTSQ (EP2) EXTSQ (EP2) 
TSSM TSSM 


Other Routines Used 


Let Slave Program Enter Master Mode FEMM (EP10 of .MFALT) 
End Courtesy Call ENCC (EP5 of .HDISP) 
MME GEINOS Processor INOS (EP5 of .HIOS) 
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RETSSX is 


OPERATING 
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RETURN TO SUBSYSTEM EXECUTION 


RETSBS is also an internal symbol of EXDRL(TSSK) for 
a routine checking all returns to subsystem 
execution. To avoid any conflict with TSSM - RETSBS, 
the symbol RETSSX iS synonymous and used by 
EXDRL(TSSK) when the return to subsystem execution 
is valid. 


PRECALLING SEQUENCE 


Prior to entering RETSSX, the registers listed must contain 
indicated. 


weasel 


Increment value,0 


CALLING SEQUENCE 


called from EXDRL or ALLOC via: 


8 16 


| RETSSX 


| 
TSX1 ) RETSBS 


SYSTEM INTERACTION 


storage is used. 


No gates are used. 


the 


RETSSX (EP3) (RETSBS) 


TSSM 


data 
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RETSSX (EP3) (RETSBS) RETSSX (EP3) (RETSBS) 
TSSM TSSM 


ROUTINE RETURNS 


Return is via a IiME GELBAR. 


POSTCALLING SEQUENCE 


None. 


SUPPORTING INFORMATION 


The first entry to a new job is with 0, Loc in the A-register. Loc is 
the subsystem entry point (#0). Thereafter, the subsystem is reentered 
with the n,0O in the A-register. The n (20) is the incremental value to 
be added to the IC before returning. Either n or Loc must be given but 
not both. The communication cell, .TCLOC, and UST entry, soles; . are 
assumed to be set. The base register value is computed, unless it is a 
master subsystem in which case the TSS base is used, and the subsystem 
is dispatched via a MME GELBAR. 


On any entry other than the first, a check is made to determine whether 
TSSJ detected an incoming BREAK that is to be passed to this subsystem. 
If this condition exists, the MME GELBAR dispatch is made via a fault 
vector located in cells 12 and 13 (octal) of the subsystem prefix. If 
the fault vector is improperly set up, TSSM exits to TSSE, which then 
transmits the message ILLEGAL BREAK VECTOR to the remote terminal and 
returns the user to system level. 


The processor time spent in subsystem execution is accumulated by 
time-sharing system Executive for accounting purposes. Upon entry to a 
subsystem (RETSBS) the processor time is stored (.TEPTS). Upon return to 
time-sharing system Executive from the GELBAR, the processor time is 
stored (.TCPRT). When a subsystem loses control because of timer run out 
or a fault, the processor time (.TCPRI-.TEPTS) is accumulated for the 
user (in -LTP of UST) and the core seconds are calculated and 
(in .LSTP of UST). 


Programming lIiethod 


RETSSX is nonreentrant and relocatable. 


Interrupts are inhibited while calculating processor time. 
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RETSSX (EP3) (RETSBS) 
TSSM 


vo ewe me 


No internal temporary storage is used. 


Other Routines Used 


Reset BAR to Smaller Area FLBAR (EP14 of .MFALT) 
Let Slave Program Enter Iaster liode FEMM (EP10 of 


RETSSX (EP 3) (RETSBS) 


. 4FALT) 


TSSII 
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UST GENERATION (TSSN) 


UST Generation routines build and release User 


St s Tables (UST) on an 
as-needed basis. At the start, the number of UST's which fit in the 
space before the swap core file (block boundary of core) is calculated 
and kept as the minimum number of UST's to be retained when space is 


released. 
TSSN contains three entry points: 


e EPIL Dynamic UST Generator (DYUST) 
e EP2 UST Collect (CUST) 
e EP3 Release UST (RUST) 


TSSN occupies approximately 270 (octal) core storage locations. 
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DYUST (EP1) DYUST(EP1) 
TSSN TSSN 


DYNAMIC UST GENERATOR 


DYUST (EP1l of TSSN) acquires space, 1k at a time, from the swap core 
file and builds the UST. 


PRECALLING SEQUENCE 


Prior to entering DYUST, the following locations in .TDCOM contain the 
data indicated. 


.- TCUST -~ Pointers to first and last UST's in use 

. TAUST - Pointer to high address of UST's, minimum 
number to be maintained 

.TAUST+1 - Amount of borrowed core (nk) 

-TAUST+2 - First UST in last k of core, last UST 
used in this k of core 

-TAUST+3 - UST collect flag, RELC counter 


CATTING SEQUENCE 


DYUST is called from LINSRV via: 


8 16 
! 
TSX1 IDYUST 
Return !(cannot generate UST immediately) 


Normal ea (L(UST) in .TCUST) 


OPERATING SYSTEM INTERACTION 
No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to LINSRV. 
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DYUST(EP1) DYUST(EP1) 
TSSN TSSN 


POSTCALLING SEQUENCE 


None. 


SUPPORTING INFORMATION 


Programming Method 


DYUST is nonreentrant and relocatable. 


Interrupts are inhibited while modifications are made in core map. 


storage 


No internal temporary storage is used. 


Other Routines Used 


Input Collector File Space Manager SYMAN) (EP7 of TSSI) 
Relinguish RLC (EP4 of .IDISP) 

Request Drum Space DRMSPC (EP1 of TSSC) 

Set Up for Swap SWAP (EP4 of TSSL) 
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CUST(EP2) CUST(EP2) 
TSSN TSSN 


UST COLLECT 


CUST (EP2 of TSSN) checks to see if the UST's need to be compacted, and 
if so, checks to see if this current user's UST is one which needs to be 
moved and if it can be moved at the present time. If these conditions 
are met, CUST moves the UST to the lowest available UST slot, adjusting 
the pointers within the UST, and the ALLOCATOR pointers (.LBACK and 
.LFLAG). CUST then transfers to clear the old UST and return space _ to 
the swap area if possible. 


PRECALLING SEQUENCE 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to LINSRV via: 


249 


GECOS III SND TSS EXECUTIVE 


CUST(EP2) 
TSSN 


POSTCALLING SEQUENCE 


SUPPORTING INFORMATION 


Programming liethod 


CUST is nonreentrant. 


Interrupts are not inhibited. 


Storage 


Internal temporary storage is used for the table 
ignored in the move. 


Other Routines Used 


Release UST RUST (EP3 of TSSN) 
System Error ERROR (EP1 of TSSF) 
Line Service LINSRV (EP1 of TSSV) 


Clear UST and liake Accounting Entry TRMCU (EP2 of TSST) 
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RUST (EP 3) 
TSSN 


RELEASE UST 


RUST (EP3 of TSSN) releases unused UST's and returns the 
swap core file, 1k at a time. 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


RUST is called from TERMPG via: 


8 16 
| Return 


OPERATING SYSTEM INTERACTION 


No .STEMP storage is used. 


No gates are used. 


ROUTINE RETURNS 


Return is to calling routine. 


POSTCALLING SEQUENCE 


None. 


RUST (EP 3) 
TSSN 


space to the 
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RUST (EP3) RUST (EP 3) 
TSSN TSSN 


SUPPORTING INFORMATION 


Programming ilethod 


RUST is nonreentrant and relocatable. 


Interrupts are inhibited while modifications are made to core map. 


Storage 


No internal temporary storage is used. 


Other Routines Used 


Input Collector File Space Manager SYMAN (EP7 of TSSI) 
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TSS STARTUP ROUTINES (TSSO) 


TSSO Startup Routines (TSSO) perform the one-pass initialization of the 


time-sharing system. TSSO also includes the majority of the routines to 
handle DATANET 760 terminals. The routines are called as required by 
Line Service and the derail processors. They are in reality an extension 
of Line Service but are located in TSSO so that the code and buffers may 
be overlayed by UST's if no DATANET 760 terminals are to be used. 


There are five functions for DATANET 760 processing as follows: 


New DATANET 760 User (GOOD76) 
Process DATANET 760 Input (760LNO) 
Reset Flags and Indicators (NEWU76) 
Release Buffer (TERM76) 

Liove Output to Buffer (KOTB9) 


Since these terminals are not common to all installations, users without 
them are not burdened with the space consuming code and buffers required 
for their implementation. Through a .TSCOM cell (.1T760) the installation 
notifies TSS at startup time how manv, if any, terminals will be allowed 
on the system at any one time. This cell can be changed whenever’ the 
GECOS III system is booted. 


If no DATANET 760 terminals are allowed, MAIN (TSTART) recognizes the 
fact and allows the UST's to overlay TSTART, as is normally done, and 
also the DATANET 760 coding which will not be required. 


If n DATANET 760 terminals are to be allowed, TSTART retains the coding, 
generates n 320-word buffers required for the operation and then 
initializes the UST's to start after this. TSTART is overlayed by the 
DATANET 760 buffers and the UST's. 


The features of the DATANET 760 which must be recognized and which 
affect other TSS routines are: 


1. Character set 
2. Maximum of 48*26 characters transmitted at one time 


3. Desirability of paging output 
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Other Routines Affected by DATANET 760 


TSSA (Communication Region) 


In block .TSCOM a cell is defined: 


-T760 ZERO 1,0 Number of DATANET 760's, 0 


TSSH (Control of User Processes) 


When the EXEC primitive is to be executed, clear the character and line 
counters and issue a form feed (clear screen and position cursor at top 


\ 
left corner). 


TSSJ (Line Service) 


1. As a new user enters the system, the terminal type is checked. 
If it is a DATANET 760, the routines in TSSO are initialized to 
assign a buffer, set flags and indicators, etc. 


2. While processing terminates, status is tested for "PRT". Le 
found, the pseudo-courtesy call is answered to issue a FF. 
3. When a user enters build-input mode: 
Use of auto mode is inhibited. 
A special procedure (760LNO) must be followed in order to 


process multiple line input. 


4. When errors occur, the pointer to the DATANET 760 buffer must 
be used for the input request. 


TSSK (Derail Processors) 


1. KOUT, KOUTN, KIN 


For an out/in request, affix an additional CR-LF at _ the 
end of the message. This is a convenience for the user as 
Lt facilitates the positioning of the cursor for 
transmission of data. 
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On input, determine if input pointer is to the DATANET 760 


buffer or UST buffer and locate the character count 


accordingly. When moving data from the DATANET 760 buffer 
replace the final ETX with CR. 


On output, examine each character for DATANET 760 control 
characters (FF, LF, CR, PR, etc.) and act accordingly. 


2. TERM -- Deallocate the DATANET 760 buffer (TERM76). 


3. NEWU -- Reset flags and indicators and initialize the buffer 
(NEWU76) . 


TSSL (Allocator) 


Do not issue the null characters at the swap. 


TSSN (Dynamic Ust, DYUST) 


NO initial UST 1s assembled with DYUST, as previously. Startup must 
first determine if DATANET 760 terminals are allowed, in which case the 
DATANET 760 buffers must precede the USTs. 
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GOOD 76 GOOD76 
TSSO TSSO 


NEW DATANET 760 USER 


The GOOD76 function of TSSO locates a DATANET 760 buffer for the user 
and links it to th UST. Buffer locations and usage are tabulated at 
-TL760 in KOTB9. The line counter is initialized according to terminal 
type code as follows: 


Type Screen lines 
5 4 
6 8 
7 16 
10 26 


-TL760 contains the following data. 


Word 0 Number of DATANET 760's allowed, number used 
Word 1 Buffer location, 0 or UST pointer 
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760LNO 760LNO 
TSSO TSSO 


PROCESS DATANET 760 INPUT 


The 760LNO function of TSSO issues the input requests for DATANET-760 


when in build-input mode. 
Prior to entering 760LNO, the buffer contains the data indicated. 


Word 0 *+4, UST pointer or zero 

1 Number of lines, line counter 
2 Current tally 

3 Number characters per line, 0 
4 Number of characters, zero 

5 


ASCII input 


760LNO issues the input request (*) when necessary and moves the data, a 
line at a time, to the UST buffer for processing in the normal 
procedure. Whereas a MME GEROUT must be issued for every line of input 
from a TTY, one MME GEROUT may be issued for up to 26 lines of DATANET 
760 input. In the buffer, word 0 points to the input data and the user. 
4& zero in the right hait of word U indicates that the buffer is 
available for assignment. 


Word 1 indicates the number of lines allowed and the current position on 
the screen. 


Word 2, if 0, means there is no data in the buffer. This is a signal to 
issue the input request (*). When data is read, the tally is established 
and thereafter points to the last line used. 


Word 3 contains the number of characters per line for this device. 


Word 4 contains the number of characters input. 
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NEWU76 NEWU76 
TSSO TSSO 


RESET FLAGS AND INDICATORS 


The NEWU76 function of TSSO resets the DATANET 760 flags and indicators 
and initializes the buffer. 


Prior to entering NEWU76, the registers listed must contain the data 
indicated. 


X2 UST address 
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TERM76 TERM76 
TSSO TSSO 


RELEASE BUFFER 


The TERM76 function of TSSO releases the DATANET 760 buffer. 

1 aA wwANI Ae ama Pane — Saari a ie es Bae ge Ty ‘ 
Prior to entering TERM76, the registers listed must contain the data 
indicated. 


X2 UST pointer 
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KOTB9 KOTB9 
TSSO TSSO 


MOVE OUTPUT TO BUFFER 


The KOTB9 function of TSSO moves the DATANET 760 output to the UST 
buffer. 


KOTB9 is called by DRL KOUT when output for a DATANET 760 user is being 
moved to the UST buffer. Output paging is done here; that is, lines are 
counted and when the screen is full, before more output is sent, an 
input request is issued. When PRT status is received, an FF to clear the 
screen is issued and the output continued. If a normal status is 
received, output is continued and will overlay the previous page. (See 
Line Service.) 


The following special characteristics and requirements are considered: 


1. All alphabetic characters must be upper case. 


2. No NULL characters (177) are issued. 


3. Characters must be counted to determine when a line wraps to 
the next line for line counting purposes. 


4. Control characters must be examined for their effect on the 
counters. 
FF - Character count and line count set to Q 
PR - Character count and line count set to 0 
LF - Increment line count by 1 or 2 depending on character 
count. If line count equals the screen size, dump the 


buffer and issue the request to continue output. 


CR - Clear character counter after testing for line wrap, 
in which case increment the line counter by 1 


BS - Reduce character count by l 
RLF- Reduce line count by 1 


FS - Increment the character counter by 1 
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MAIN MAIN 
TSSO TSSO 


TIME-SHARING SYSTEM STARTUP 


MAIN (TSSO) initializes communication cells, the fault vector, and the 
PAT pointers. The available TSS Subsystems are also moved to the #P or 
#Q files, and the program descriptor tor each subsystem is initialized. 


PRECALLING SEQUENCE 


None. 


CALLING SEQUENCE 


TSSO is called from GECOS III by the .ENTRY macro. 


(ODE RVING. SY SAR B ED) ON IDE RC EDOM 


-STEMP+8 and .STEMP+9 are used for. link information exchange with 
.MALC2, EP1. 


-CRPOQ is shut while a call to .iiPOP6é, EP2 is put into the queue. 


ROUTINE RETURNS 


Return is to LINSRV. 


POSTCALLING SEQUENCE 


None. 
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MAIN MAIN 
TSSO TSSO 


SUPPORTING INFORMATION 


Loading the time-sharing system acti 


MAIN (TSTART) initializes the fault vector and clears all unused cells 
at addresses less than 100. The PAT pointers for SY** and other system 
temporary files are constructed. The subsystems are collected and stored 
on #P and #Q files for rapid accessibility. Normally, #P will be 
assigned on the fastest available device and #Q on the next available 
device. By means of a parameter in the Program Descriptor Name table at 
IN900, systems are assigned to #P or #Q. Little used systems may be 
assigned to #Q. Since the total required space on #P and #Q may vary 
from installation to installation, it is not necessary to open the files 
with the total required space. As more space is needed, a GEMORE request 
is issued. 


The size of available core for subsystem execution is calculated and the 
core map initialized. The space occupied by TSTART module is also 
included as available core space. 


After initializing time cells in the Communication Region, control is 
sent to Line Service to activate the time-sharing system. 


The maximum number of time-sharing system users is specified 
right-justified in word .TFMAX in the Communication Region. This word is 
used by TSTART to determine how many slave service areas (SSA) are 
needed to handle the number of users specified. The number of SSA's 
required for n users is determined from a table in TSTART called USERS. 
The system as presently implemented has .TFMAX set to 18 users. The 
allocation of SSA's is based on the table in the following manner: 


USERS DEC 19 1-18 Users Requires 2 SSA's 
+1 DEC 37 19-36 Users Requires 4 SSA's 
+2 DEC 55 37-54 Users Requires 5 SSA's 
+3 DEC 73 55-72 Users Requires 6 SSA's 
+4 DEC 180 over 72 Users Requires 7 SSA's 


If a site's requirements are for 19 or more users, it is advantageous 
that the actual maximum number of users anticipated be placed in .TFMAX. 
The utilization of space within the slave service areas is based on the 
number of users specified in .TFMAX. The first slave service area is 
required by GECOS III and the second is used for I/O queues required to 
handle the number of users specified in .TFMAX. The remainder of the 
second slave service area plus the other slave service areas is used to 
contain as many PAT tables as possible (i.e., as many open files as 
possible). Thus by specifying the actual maximum number of users in 
-TFMAX, a Significant gain may be realized in PAT space. 
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MAIN MAIN 
TSSO TSSO 


Cell .TFMAX can be changed by patching the GECOS III startup deck if the 
maximum number of users at a site is changed from day-to-day. .TFMAX can 
also be changed by reassembling the Communication Region with a new 
value in .TFMAX. 


Ts era alsa a sms ~ -~ mM ~ 22-42 A = 
With the system as released, the limit on the number of files that can 


a 
be open at the same time is 640. 


Programming Method 
MAIN is nonreentrant and relocatable. 


Interrupts are inhibited while major initialization is in process. 


Storage 


iiwAIN 1s overlayed into TSSA by the loader and startup takes place there, 
TSSA is then reinitialized to its required state at conclusion of 
startup activities. 


Other Routines Used 


Let Slave Program Enter Master Mode FEMM (EP10 of .MFALT) 
Relingquish RLC (EP4 of .MDISP) 

Enable Program ENB (EP6 of .MDISP) 

Relinguish Control Until Program Enabled DSCNT (EP11 of .MDISP) 
Process Specific Device Request ENTRY (EP1 of .MALC2) 

File System Initialization and Iiodule Selection FSINIT (EP1 of .liFS09) 
Roadblock GRD (EP2 of .MDISP) 

Assign An I/O Entry QUEUE (EP4 of .MIOS) 

Master Message Processor ITYM (EP7 of .MIOS) 

Terminate Error Entry FALT (EP3 of .MBRT1) 

User GECALL Load Processing MCAL (EP1l of .MCAL1) 

MME GEINOS Processor INOS (EP5 of .HIOS) 

MME GEMORE Processor MORE (EP1 of .MMORE) 

Provide Date and Time of Day FGTIM (EP8 of .MFALT) 
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APPENDIX A. SYSTEM MACROS 


The time-sharing system modules and subsystems require many definitions 
of the Communication Region, User Status Table (UST) contents, derails, 
etc. These have been formulated into a set of macros. They are loaded by 


LODM 


-G3TSn 


(The proper choice of n will be defined at the time of an SDL 
distribution. ) 


The macros and their uses are as follows: 


. TSCOM 


~-5SSCOM 


~SssusTt 


~SSDRL 


PRNTTY 


Should appear in all time-sharing system decks and contains 
all the common communication definitions and the macro call 
-SSUST for the UST equivalences. 


Should appear in all master subsystem decks and contains 
the common communication definitions and the macro calls 
-SSUST and .SSDRL. These will cause the UST and DRL 
equivalences to be included. 


All privileged subsystems should use this macro to provide 
the UST and DRL equivalences. 


Normal subsystems should use this macro to obtain the DRL 
definitions. 


n, (message n characters long) ,K 
Used to print the error message from a subsystem. K 
(optional) is a pointer to a word containing control 


characters to be affixed to the end of the line 
(CR,LF,NULL, etc.). 
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APPENDIX B. TIME-SHARING SYSTEM DECK SETUP AND MEMORY LAYOUT 


The deck set-up and memory layout of the time-sharing system are 
illustrated below. The only restriction is one that TSCOM (communication 
block) must be first and TSTART (TSSO) must be last. When calculating 
the extent of the swap area, startup assumes it can overlay itself. 


/ 
/_$ EXECUTE 


/ $ DKEND 


/ 
/ Binary Deck 
/ 
iS $ OBJECT TSTART 
/ 


/_§$ OBJECT DYUST 


/ 
é 


/ 
/ Binary Decks 


/ 
/ 


/ $ OBJECT 
/ $ DKEND 


/ 
/ Binary Deck 


/ $ OBJECT TSCOM 
is ENTRY MAIN 
/ $ LOWLOAD 
/s NOLIB 


/ 
/ $ OPTION NOSETU 


Deck Setup of Time-Sharing System 
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Swap 


GSTART oof tc 
DYUST 


Time-Sharing 
System 


110 


0 Fault Vector - GECOS Area 


Slave Service Area l 


Slave Service Area n 


Memory Layout of Time-Sharing System 


The User Status Tables are constructed/released as _ needed. 
Space is obtained/released to the bottom of the Swap. area. 
Although GECOS III assigns a specific amount of core to _ the 
time-sharing system at load time, it is possible to request 
core size changes from the console. If efficiency or response 


time deteriorates because of crowded conditions in the 
SWAP-UST area, a message may be issued at the console to that 
effect. 
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APPENDIX C. ERROR MESSAGES 


SYSTEM ERRORS 


All the possible time-sharing system error messages which are output at 
the GE-600 operator's console are described in detail in the GE-600 Line 
Typewriter Messages reference manual, CPB-1477. 


SUBSYSTEM ERRORS 


Subsystem error messages detected by the executive and received at a 
terminal are listed below, with the source of the message given. The 
messages are number-coded when they apply to the HELP subsystem, where 
explanations and suggested corrective actions are given. 


Error Code No. Error iiessadge Source 
ool INCORRECT PRIMITIVE CONTROL 
002 BAD FILE I/O COMMAND DRL DIO 
003 BAD DCW DRL DIO 
004 ADDRESS OUT OF RANGE DRL 
005 BAD DRL CODE DRL 
006 LEVEL OF CONTROL TOO DEEP CONTROL,DRL CALLSS 
007 BAD PROG. DESC. CONTROL 
008 LOOP IN PRIMITIVES CONTROL 
009 SYSTEI1 UNKNOWN STARTP 
010 PROGRAM TOO LARGE TO SWAP ALLOC 
O11 INCORRECT CORE FILE USAGE DRL CORFIL 
Qi2 PROGRAM NOT ALLOWED USE OF DRL DIO 

THIS 1/0 
013 DRL ALLOWED ONLY BY LOGON DRL USERID 
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014 REQUEST RELEASE OF TOO MUCH DRL RELMEM 
CORE 
O15 CAN NOT RESET ID DRL USERID 
016 OVERFLOW FAULT EXEC 
017 ILLEGAL OP CODE EXEC 
018 MEMORY FAULT EXEC 
019 FAULT TAG FAULT EXEC 
020 DIVIDE CHECK FAULT EXEC 
021 BAD STATUS SWAP OUT #S ALLOC 
022 BAD STATUS SWAP IN #S ALLOC 
023 BAD STATUS LOAD #P ALLOC 
024 BIT POSITION > 35 CONTROL 
025 YOU HAVE FILE ACCESSED WITHOUT DRL DIO 
WRITE PERMISSION 
026 YOU HAVE FILE ACCESSED WITHOUT DRL DIO 
READ PERMISSION 
027 ADDRESS IS OUTSIDE OF FILE DRL DIO 
LIMITS 
028 READ LINKED FILES ONLY WITH DRL FILSP 
THIS COMMAND 
029 ILLEGAL SYSTEM SELECTION CONTROL 
134 INVALID FUNCTION NUMBER IN DRL FILACT 
DRL FILACT 
135 USER CANNOT ACCESS THE SYSTEM DRL FILACT 
MASTER CATALOG 
138 TAP* FILE UNDEFINED DRL DRLPT of 
LINSRV 
139 ERROR IN WRITING TAP* TAPE LINS RV 
DRL ABORT - FILE NOT SAVED DRL ABORT 
DRL ABORT - PROGRAM DUMPED DRL ABORT 
NOT ENOUGH CORE TO RUN JOB ALLOC 
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SORRY - OUT OF SWAP SPACE. ALLOC 
TRY AGAIN 
FILE ADDRESS ERROR- RETRY DRL DIO 
DRL ABORT - ERROR ON PROGRAM DRL ABORT 
DUMP 
DRL ABORT - ABRT FILE TOO DRL ABORT 
SMALL FOR ENTIRE DUMP 
BAD STATUS - DRL RESTOR FILE DRL RESTOR 
RESTORE FILENAME NOT IN AFT DRL RESTOR 
064 EXECUTE TIME LIMIT EXCEEDED EXEC 
ILLEGAL BREAK VECTOR EXEC 
065 OBJECT PROGRAM SIZE ALLOC 


LIMIT EXCEEDED 


INCORRECT ENTRY TO DRL TASK DRL TASK 


RESTOR PROGRAM NAME UNDEFINED 


REACHED CATALOG LIMIT ON 


DRL SAVE DRL SAVE 
DRL PSEUDO: TALLY INCORRECT DRL PSEUDO 
BAD DRL SAVE DATA LOCATION DRL SAVE 


DRL SAVE-DO FIRST PROGRAM 
SAVE BEFORE ADDED PROG. DRL SAVE 


DRL SAVE ON RANDOM FILE ONLY DRL SAVE 


TERMINAL TYPE NOT ALLOWED 
DRL PSEUDO DRL PSEUDO 
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APPENDIX D. USER ACCOUNTING 


It is necessary to accumulate usage data on an "as-you-go" basis, so 
that each user is charged according to his use of the system. Within the 
time-sharing system, four factors are considered: core-seconds, number 
of disc I/O requests, number of characters output to the remote 
terminal, and elapsed time during which the user is connected to the 
time-sharing system. 


The data is accumulated in several locations within the system. As_ the 
times or counts are detected, they are accumulated into the User Status 
Table. When the user enters the system and acquires a User Status Table, 
the sign-on time is stored in .LTALC by LINSRV (Line Service). The 
difference between »~LTALC and the sign-off time provides the 
elapsed-time factor. 


In EXEC, when control is given to a subsystem, the processor time is 
noted. When that subsystem subsequentiy ioses control, the processor 
time is multiplied by the subsystem core size and accumulated into -LSTP 
LOL Che Gesiyliatcu uSeL.e A iiat Clarye OL zZ ibbibtisecuidus pes tiivusaid ae 
core is charged for a derail (TSDRL). 


In TSDRL, each request for a file I/O is counted in the lower half of 
-LSTIO. Also, whenever a buffer of key output is ready, the count of key 
characters divided by 8 is added into the upper half of .LSTIO. 


The user charges are calculated in the subsystems LOGOFF, NEWU, and 
TERM. In LOGOFF, the calculation is made to print the signoff message 
for the user's information. In TERM, the calculation is made in order to 
update the user's information. In TERM, the calculation is made in order 
to update the user's accounting file. In NEWU, the calculation is made 
both for the message and to update the user's accounting file. 


When the user is disconnected, a record is written during the 
termination process on the GECOS III accounting file for the user. The 
following is the format of the information written. 


273 


SO UB WN FE 


\© © 


10 
11 


GECOS III SMD TSS EXECUTIVE 


Number of Size and type record 
words 
(9 or 11) 
« CRDAT Date 
ID (char. 1-6) \ User ID 
ID (char. 7-12) 
current time Time of termination 
. LTALC , 2 Time user entered TSS 
-LSTIO,2 Number of TTY char/8, 
Number of disc I/0 
-LSTP,2 Core seconds used 
Cost Calculated Charge (¢) 
1-6 BCI-char. chg. no. Conditional upon use 
HETe ECi=chaty cg, nov —]} of charge nunber 


The following formula describes the computation: 


Cost of time-sharing system session = 


[(.LSTP*P, + .LSTIO pow *.3*Py + .LSTIOyp *P3/C + 


(.LTALC - Time) * P, ) Ks | Pe 


where: 
.LSTP = accumulated core-seconds used 
-LSTIO;9y = number of disc I/O's performed 
- LSTIO pp = number of characters (key I0/8) 
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charge for core seconds/hour 
charge for disc I/O time/hour 
charge for page of key I/O 
average number characters/page 
charge for elapsed time/hour 
multiplication factor 


priority factor 
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The parameters are assembled in the programs LOGOFF, TERM, and NEWU at a 
specific place and in a specific order to facilitate changes by assembly 
or patching. In each case, they will be located just following the 
required 100 word subsystem date area at assembled location 144 (octal) 


{loaded location 254 (octal)). 


The parameter order, format, and present values are as follows: 


DEC 600 Elapsed time price/hour $ 6.00 
DEC 1000 Core second price/hour 10.00 
DEC 2400 Disc I/O price/hour 24.00 
DEC 2 Price/page key I/O 0.02 
DEC ua Multiplication factor K 

DEC 100 

DEC 110 

DEC 20 

DEC 130 

DEC 140 Priority factor table 

DEC 150 

DEC 160 

DEC 170 

DEC 180 

DEC 190 

DEC 2000 Average number characters of key I/O per page 
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760 
»~LCCTR DATANET 760 character count 
-LBPTR DATANET 760 buffer pointer 
DATANET 760 
NEW DATANET 760 USER 
PROCESS DATANET 760 INPUT 


760LNO 
760LNO function of TSSO 


ABORT 
»~LRMAX Number of system errors allowed before abort 
-LBRT Location of abort, reason code 
ABORT USER 
DRLABT (DRL ABORT, TSSK) 
ABORT A JOB 


AB'LJUOB 
ABTJOB (DRL ABTJOB, TSSK) 


ACCOUNTING 
CLEAR UST AND MAKE ACCOUNTING ENTRY 
Accounting File Request ACTFL 
Clear UST and Make Accounting Entry TRMCU 
Clear UST and Make Accounting Entry TRMCU 
Clear UST and Make Accounting Entry TRMCU 
USER ACCOUNTING 


ACCUMULATING 
Accumulating Build Mode Input 


ACTFL 
Accounting File Request ACTFL 


ACTIONS 
Summary of Primitive Actions 


ACTIVITY 
SPAWN A SPECIAL BATCH ACTIVITY 


ADD 
ADD MEMORY 
ADD LINKS TO TEMPORARY FILE 


69 


53 


218 


141 
170 
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ADDMEM 
ADDMEM (DRL ADDMEN, TSSK) 


ADDRESS 
~LRAP Wrapup address 
user's courtesy call address, .LCC 


ADJUSTMENT 
Core Size Adjustment ALL7AC 
Core Size Adjustment ALL7AC 
CORE SIZE ADJUSTMENT 


AFT 
-LFILE Pointer to program stack and AFT 
Available File Table (AFT) 
Search the AFT SRCH 
SEARCH THE AFT 
Search the AFT SRCH 
Pass AFT to a Subsystem PASAFT 
Search the AFT SRCH 
Search the AFT SRCH 
Search the AFT SRCH 
PASS AFT TO A SUBSYSTEM 
Search the AFT SRCH 
Search the AFT SRCH 
Search the AFT SRCH 
Search the AFT SRCH 
Search the AFT SRCH 
PASS AFT NAMES AND DESCRIPTIONS 
Search the AFT SRCH 
Search the AFT SRCH 
Search the AFT SRCH 
Pass AFT to Subsystem PASAFT 
Search the AFT SRCH 
Search the AFT SRCH 
Search the AFT SRCH 


ALL7AC 
Core Size Adjustment ALL7AC 
Core Size Adjustment ALL7AC 
Core Allocator ALL7AC 
ALL7AC (EP3 of TSSL) 


ALLOC 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
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ALLOC (continued) 


Update Allocator Queue ALLOC 140 
Update Allocator Queue ALLOC 142 
Update Allocator Queue ALLOC 156 
Update Allocator Queue ALLOC 159 
Update Allocator Queue ALLOC 163 
Update Allocator Queue ALLOC 177 
Update Allocator Queue ALLOC LB t 
Update Allocator Queue ALLOC 183 
Update Allocator Queue ALLOC 185 
Update Allocator Queue ALLOC 196 
Update Allocator Queue ALLOC 200 
Update Allocator Queue ALLOC 207 
Update Allocator Queue ALLOC 209 
Update Allocator Queue ALLOC 217 
Update Allocator Queue ALLOC 220 
ALLOC (EP1 of TSSL) 227 
Update the Allocator Queue ALLOC 239 
ALLOCATE : 
Allocate Job in Queue ALLOCI 87 
ALLOCATE JOB IN QUEUE 230 
ALLOCATION 
FILE ENTRY SPACE ALLOCATION 29 
File Entry Space Allocation PATMAN oot 
File Entry Space Allocation PATMAN 127 
File Entry Space Allocation PATMAN nr 
File Entry Space Allocation PATMAN LT 
File Entry Space Allocation PATMAN 220 
ALLOCATION AND DISPATCH OF SUBSYSTEM PROGRAMS (TSSL) 224 
ALLOCATOR 
SWAP SPACE ALLOCATOR (TSSC) 21 
Update Allocator Queue ALLOC 44 
Update Allocator Queue ALLOC 50 
Update Allocator Queue ALLOC 64 
Update Allocator Queue ALLOC 67 
Update Allocator Queue ALLOC 69 
Update Allocator Queue ALLOC 87 
Update Allocator Queue ALLOC Lad 
Update Allocator Queue ALLOC Lo 
Update Allocator Queue ALLOC 124 
Update Allocator Queue ALLOC 129 
Update Allocator Queue ALLOC 140 
Update Allocator Queue ALLOC 142 
Update Allocator Queue ALLOC 156 
Update Allocator Queue ALLOC 159 
Update Allocator Queue ALLOC 163 
Update Allocator Queue ALLOC hy a 
Update Allocator Queue ALLOC 181 
Update Allocator Queue ALLOC es 
Update Allocator Queue ALLOC 185 
Update Allocator Queue ALLOC 196 
Update Allocator Queue ALLOC 200 
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ALLOCATOR (continued) 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
UPDATE ALLOCATOR QUEUE 
Core Allocator ALL7AC 
Update the Allocator Queue ALLOC 
TSSL (Allocator) 


ALLOCI 
Allocate Job in Queue ALLOCI 
ALLOCI (EP2 of TSSL) 


ALL-POINTS 
all-points bulletin (APB) 


APB 
alli-points builetin (APB) 


ARGUMENT 
»LERRM Argument to PNTERR zero 


ASSIGN 
Assign an I/O Entry QUEUE 
Assign An I/O Entry QUEUE 


ASSIGNMENT 
Peripheral Assignment Table (PAT) 


ASSIGNMENTS 
UST Assignments 


AUTO 
.~LINNO Line number for auto mode 
~LINCR Increment for auto mode 


AVAILABLE 
Available File Table (AFT) 
available space chain 


BACKS PACE 
FORWARD / BACKSPACE A FILE 


BACKWARD 
-LBACK Backward pointer priority value 


BAR 
Reset BAR to Smaller Area FLBAR 
Reset BAR to Smaller Area FLBAR 


BASE 
~LSIZE Base in TSS size in core 
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207 


NNO 


aug 


217 


(od) 
com) 


~J~ 


28 
28 


.-LSNUB SNUMB of batch job waiting 
PASS FILE TO BATCH PROCESSOR 

BATCH OUTPUT REQUEST 

PASS FILE TO REMOTE BATCH PROCESSOR 
SPAWN A SPECIAL BATCH ACTIVITY 


BCI 
»~LCHG 1-12 character BCI charge number 


BIN 
BIN 


BLOCK 
~LSWAP Block No. on drum actual size 
-LCFIL Ten-word block for core file 
~LSYBC *SRC*TAP block count 
-LADW1 Swap DCWl and block number cel i 
Communication Region block, .TSCOM 
biock .TPRGD 
BLOCK NUMBER 
»=LBKMX Block number threshold for scratch file 


BREAK 
e-LBRK Break fault 


BUFDMP 
Buffer Dump BUFDMP 
BUFDMP (EP4 of TSSK) 
Buffer Dump BUFDMP 
Buffer Dump BUFDMP 
Buffer Dump BUFDMP 
Buffer Dump BUFDMP 


BUFFER 
-LBUF Buffer B* T* station ID 
-~LBPTR DATANET 760 buffer pointer 
-LBUFS Number of words in line buffer 
Buffer Dump BUFDMP 
Transmit Data to Buffer STOBUF 
Set Tally for Output Buffer STBTAL 
BUFFER DUMP 
SET TALLY FOR OUTPUT BUFFER 
TRANSMIT DATA TO BUFFER 
Set Tally for Output Buffer STBTAL 
Transmit Data to Buffer STOBUF 
Buffer Dump BUFDMP 


uo 
Aw 


AO mAaANAAN 


nd 
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BUFFER (continued) 
Release Buffer TERM76 
Buffer Dump BUFDMP 
Buffer Dump BUFDMP 
KEYBOARD OUTPUT FROM UNFILLED BUFFER 
Set Tally for Output Buffer STBTAL 
Transmit Data to Buffer STOBUF 
Buffer Dump BUFDMP 
RELEASE BUFFER 
MOVE OUTPUT TO BUFFER 


BUILD 
Accumulating Build liode Input 
Enabling Command Processing In Build Mode 
BUILD MODE PROCESSING OF INPUT 


BULLETIN 
all-points bulletin (APB) 
BYPASS 
-LDAT Current loc of data bypass count 
B* 
-LBUF Buffer B* T* station ID 
CALL 
INTERNAL CALL TO ANOTHER SUBSYSTEM 
Partial Release of Mass Storage File CALL 
Paper Tape Courtesy Call PPTCCl 
CALLP 
CALLP 
CALLSS 
-~LCALS CALLSS pushdown list 
~LPRSS Number entries in CALLSS pushdown list 
CALLSS (DRL CALLSS, TSSK) 
CC REQD 
CC REQD bit 
CGROUT 
CGROUT (DRL CGROUT, TSSK) 
CHAIN 
available space chain 
CHARACTER 


»LCCTR DATANET 760 character count 
-LCHG 1-12 character BCI charge number 


CHARGE NUMBER 
-LCHG 1-12 character BCI charge number 
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EAR UST AND MAKE ACCOUNTING ENTRY 
x UST and Make Accounting Entry T 
Acco i 


-LBRT Location of abort, reason code 


COLLECT 
UST Collect CUST 
UST COLLECT 


COLLECTOR 
INPUT COLLECTOR FILE SPACE MANAGER 
Input Collector File Space Manager SYMAN 
Input Collector File Space Manager SYMAN 


COMMAND 
SCAN FOR KNOWN COMMAND WORD 
Enabling Command Processing In Build liode 
Scan for Known Command Word SCAN2 


COMMUNICATION REGION 
COMMUNICATION REGION (TSSA) 
Communication Region block, .TSCOM 
cCohutuntcation kegion (1s5A) 
TSSA (Communication Region) 


COMMUNICATIONS DEFIN 
communications definition macro 


COMPILER 
BASIC compiler 


CONDITIONAL 
Conditional MME GEROUT Entry FGROUT 


CONS OL 
CONSOL (DRL CONSOL, TSSK) 


CONSOLE 
MASTER TTY/600 CONSOLE TALK 


CONTROL 
Time-Sharing System Flow of Control 
CONTROL OF USER PROCESSES (TSSH) 
SCAN FOR CONTROL LANGUAGE 
Relinquish Control Until Program Enabled DSCNT 
Scan for Control Language SCAN1 
TSSH (Control of User Processes) 
Relinguish Control Until Program Enabled DSCNT 


61 
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CORE 


-LSIZE Base in TSS size in core 
-LCFIL Ten-word block for core file 
Core Size Adjustment ALL7AC 

READ / WRITE CORE FILE 
PROCESSOR.TIME AND CORE SIZE LIMIT 


Installation core size and processor time limits 


Core Size Adjustment ALL7AC 
Core Allocator ALL7AC 
CORE SIZE ADJUSTMENT 


CORFIL 


CORFIL (DRL CORFIL, TSSK) 


COUNT 


~LDAT Current loc of data bypass count 
»~LSYBC *SRC*TAP block count 

-LKYSS Key I/O count at subsystem start 
~LDCSS Disc I/O count at subsystem start 
~LCCTR DATANET 760 character count 

»-LNDRC Number of entries in DRL count table 


COURTESY CALL 


CUS 
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-LCC Courtesy call return 

Swap courtesy call by user 
.~LTRM Terminate courtesy call 
End Courtesy Call ENCC 

End Courtesy Call ENCC 

End Courtesy Call ENCC 

courtesy call word 

user's courtesy call address, .LCC 
End Courtesy Call ENCC 

PAPER TAPE COURTESY CALL 

End Courtesy Call ENCC 

Paper Tape Courtesy Call PPTCC1 
End Courtesy Call ENCC 

End Courtesy Call ENCC 

End Courtesy Call ENCC 

End Courtesy Call ENCC 

End Courtesy Call ENCC 

End Courtesy Call ENCC 

PAPER TAPE COURTESY CALL PPTCC1 
End Courtesy Call ENCC 

End Courtesy Call ENCC 

End Courtesy Call ENCC 

End Courtesy Call ENCC 

End Courtesy Call ENCC 


T 
UST Collect CUST 
CUST (EP2 of TSSN) 


SINS OD OD 


Tr 
uk 


-LLTOT Number of new users per cycle 


DATA 
-LDAT Current loc of data bypass count 
Transmit Data to Buffer STOBUF 
TRANSMIT DATA TO BUFFER 
Transmit Data to Buffer STOBUF 
Transmit Data to Buffer STOBUF 

DATANET 


-LCCTR DATANET 760 character count 
»-LBPTR DATANET 760 buffer pointer 

Send "Stop Paper Tape" to DATANET PPTOFF 
Send "Stop Paper Tape" to DATANET PPTOFF 
SEND "STOP PAPER TAPE" TO DATANET 
DATANET 760 

NEW DATANET 760 USER 

PROCESS DATANET 760 INPUT 


DATANET- 760 
New DATANET-760 User GOOD76 


DATE 
Provide Date and 


Time of Day Ff 


oe 


NGaaan 


biLouvaue bale ana 
OBTAIN PROCESSOR 
Provide Date and 
Provide Date and 


tithe OL vay 
TIME, DATE, 
Time of Day 
Time of Day 


FEGLLhi 
TIME OF DAY 
FGTIM 
FGTIM 


Provide Date and Time of Day FGTIM 
DCWw1l 

»~LADW1 Swap DCWl and block number cell 
DCW'S 

»~LADCW Max. number swap DCW's 


DEACCESS 
Deaccess File FSINT1 


DEALLOCATION 
FILE DEALLOCATION 
File Deallocation PATDEA 
File Deallocation PATDEA 


DECK SETUP 


TIME-SHARING SYSTEM DECK SETUP AND MEMORY LAYOUT 


DEFIL 
DRLFIL (DRL DEFIL, TSSK) 


DEFINE 
DEFINE A TEMPORARY FILE 
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125 


125 
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DELINKING 


DELINKING 
Delinking 
Delinking 
Delinking 
Delinking 
Delinking 
Delinking 


DERAIL 


FILE 
File 
File 
File 
File 
File 
File 


poooon ow Pp 


FREE 
FREE 
FREE 
FREE 
FREE 
FREE 


DERAIL PROCESSORS (TSSK) 
Return to Subsystem from 
RETURN TO SUBSYSTEM FROM 
DISC I/O DERAIL 
Subsystem from 
Subsystem from 
Subsystem from 
Subsystem from 
Subsystem from 
Disc I/O Derail DRLDIO 
Disc I/O Derail DRLDIO 
Return to Subsystem from 
Return to Subsystem from Derail RETSBS 
Derail Entry From Executive EXDRL 

TSSK (Derail Processors) 


Return 
Return 
Return 
Return 
Return 


No te 


to 
to 
to 
to 


to 


DESCRIPTION 
»LTDES File description of PPT 


DESCRIPTIONS 
SUBPROGRAM DESCRIPTIONS (EXECUTIVE) 
PASS AFT NAMES AND DESCRIPTIONS 


DESCRIPTOR 


~LNPD Number of entries 


DEVICE 


Process Specific 
Process Specific 
Process Specific 


DIO 


DRLDIO (DRL DIO, 


DIRECT-ACCESS 


Device 
Device 
Device 


TSSK) 


direct-access queue 


DISC 


-LDCSS Disc I/O count at subsystem start 


Derail 
DERAIL 


Derail 
Derail 
Derail 
Derail 
Derail 


Derail 


in program 


RETSBS 


RETSBS 
RETSBS 
RETSBS 
RETSBS 
RETSBS 


RETSBS 


Request ENTRY 
Request ENTRY 
Request ENTRY 


Executive Disc I/O TSXDIO 
EXECUTIVE DISC I/O 
DISC I/O DERAIL 
PRIVILEGED DISC I/O 
Executive Disc I/O TSXDIO 
Executive Disc I/O TSXDIO 
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159 


220 


115 


186 
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DISC (continued) 


Disc I/O Derail DRLDIO 177 
Disc I/O Deraii DRLDIO 200 
Executive Disc I/O TSXDIO 217 
Executive Disc I/O TSXDIO 220 
Executive Disc I/O TSXDIO 239 
DISCONNECT 
LOG-ON NEW USER WITHOUT DISCONNECT 172 
DISCONNECT TERMINAL 184 
DISC- REMOTE 
-LIOST I/O status - disc-remote 6 
DISC/DRUM 
-LSFTM 4-word LINSRV pointer disc/drum R/W 7 
DISPATCH 
ALLOCATION AND DISPATCH OF SUBSYSTEM PROGRAMS (TSSL) 224 
DRL 
-LNDRC Number of entries in DRL count table 7 
DRLDIO (DRL DIO, TSSK) 115 
DRLKOT (DRL KOUT, TSSK) 118 
DRLKON (DRL KOUTN, TSSK) 120 
DRLKIN (DRL KIN, TSSK) 121 
DRLRET (DRL REVURN, VSSK) 123 
DRLFIL (DRL DEFIL, TSSK) 125 
DRLABT (DRL ABORT, TSSK) 128 
DRLSET (DRL SETSWH, TSSK) 130 
DRLRST (DRL RSTSWH, TSSK) 132 
DRLREW (DRL REW, TSSK) 133 
DRLSPF (DRL FILSP, TSSK) 135 
DRLRFL (DRL RETFIL, TSSK) 137 
RELMEM (DRL RELMEH, TSSK) 139 
ADDMEIi (DRL ADDMEM, TSSK) 141 
CORFIL (DRL CORFIL, TSSK) 143 
SNUMB (DRL SNUMB, TSSK) 145 
TIME (DRL TIME, TSSK) 147 
PASAFT (DRL PASAFT, TSSK) 149 
TERMTP (DRL TERMTP, TSSK) 151 
PDIO (DRL PDIO, TSSK) 153 
RESTOR (DRL RESTOR, TSSK) 155 
PASFIL (DRL SPAWN, TSSK) 157 
DRLPPT (DRL TAPEIN, TSSK) 160 
CALLSS (DRL CALLSS, TSSK) 162 
USERID (DRL USERID, TSSK) 164 
TERMPG (DRL TERMPG, TSSK) 166 
PASUST (DRL PASUST, TSSK) 168 
MORLNK (DRI MORLNK, TSSK) 170 
NEWUSR (DRL NEWUSR, TSSK) 172 
FILACT (DRL FILACT, TSSK) 174 
SETLNO (DRL SETLNO, TSSK) 178 
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DRL (continued) 
SYSRET (DRL SYSRET, TSSK) 
STPSYS (DRL STPSYS, TSSK) 
DRLDSC (DRL DRLDSC, TSSK) 
PASDES (DRL PASDES, TSSK) 
JSTS (DRL JSTS, TSSK) 
CGROUT (DRL CGROUT, TSSK) 
PART (DRL PART, TSSK) 
GROW (DRL GROW, TSSK) 
ABTJOB (DRL ABTJOB, TSSK) 
CONSOL (DRL CONSOL, TSSK) 
DRLSWH (DRL SWITCH, TSSK) 
DRLIMT (DRL DRLIMT, TSSK) 
JOUT (DRL JOUT) 
OUTNOW (DRL KOTNOW, “™SSK) 
OBJTIM (DRL OBJTIM) 
PASFLR (DRL PASFLR) 
PPTOFF/PPTERM (DRL STOP: ™) 


SAVE (DRL SAVE) 


TASK (DRL TASK) 
FAKEIN (DRL PSEUDO, TSSK) 


DRLABT 
DRLABT (DRL ABORT, TSSK) 


DRLDIO 
DRLDIO (DRL DIO, TSSK) 
Disc I/O Derail DRLDIO 
Disc I/O Derail DRLDIO 


DRLDSC 
DRLDSC (DRL DRLDSC, TSSK) 


DRLPFIL 
DRLFIL (DRL DEFIL, TSSK) 


DRLIMT 
DRLIMT (DRL DRLIMT, TSSK) 


DRLKIN 
DRLKIN (DRL KIN, TSSK) 


DRLKON 
DRLKON (DRL KOUTN, TSSK) 


DRLKOT 
DRLKOT (DRL KOUT, TSSK) 


DRLPPT 
DRLPPT (DRL TAPEIN, TSSK) 


DRLRET 
DRLRET (DRL RETURN, TSSK) 
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180 
182 
184 
186 
189 
191 
£93 
195 
197 
1:99 
201 
203 
205 
208 
210 
213 
214 
216 
218 
221 


128 


LAS 
177 
200 


184 


125 


203 


121 


120 


118 


160 
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DRLREW 

DRLREW (DRL REW, TSSK) £33 
DRLRFL 

DRLRFL (DRL RETFIL, TSSK) Lad 
DRLRST 

DRLRST (DRL RSTSWH, TSSK) 132 
DRLSET 

DRLSET (DRL SETSWH, TSSK) 130 
DRLSPF 

DRLSPF (DRL FILSP, TSSK) 33 
DRLSWH 

DRLSWH (DRL SWITCH, TSSK) 201 
DRMSPC 

DRMSPC (EP1l of TSSC) 22 

Request Drum Space DRMSPC 231 

Request Drum Space DRMSPC ve S| 

Request Drum Space DRMSPC 248 
DRUM 

-LSWAP Biocn No. of Grum actual sige S 

drum tlap (.TADMP) 21 
DRUM SPACE 

REQUEST DRUM SPACE 22 

RETURN DRUM SPACE 24 

Return Drum Space RETSPC 229 

Request Drum Space DRMSPC 231 

Request Drum Space DRMSPC 233 

Request Drum Space DRMSPC 248 
DSCNT 

Relinquish Control Until Program Enabled DSCNT 86 

Relinguish Control Until Program Enabled DSCNT 263 
DUMP 

Buffer Dump BUFDMP 50 

BUFFER DUMP 103 

Buffer Dump BUFDMP 124 

Buffer Dump BUFDMP 181 

Buffer Dump BUFDMP 185 

Buffer Dump BUFDMP 225 
DVTB1L 

DVTBL 14 
DVTB2 

DVTB2 14 
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DYNAMIC 
Dynamic UST Generator DYUST 86 
DYNAMIC UST GENERATOR 247 
TSSN (Dynamic Ust, DYUST) 255 
DYUST 
Dynamic UST Generator DYUST 86 
DYUST (EP1 of TSSN) 247 
TSSN (Dynamic Ust, DYUST) 255 
EDIT 
Program Descriptor for EDIT 61 
ENABLE 
Enable Program ENB 159 
Enable Program ENB 207 
Enable Program ENB 220 
Enable Program ENB 263 
ENABLED 
Relinquish Control Until Program Enabled DSCNT 86 
Relinquish Control Until Program Enabled DSCNT 263 
ENB 
Enable Program ENB 159 
Enable Program ENB 207 
Enable Program ENB 220 
Enable Program ENB 263 
ENCC 
End Courtesy Call ENCC 39 
End Courtesy Call ENCC 44 
End Courtesy Call ENCC 67 
End Courtesy Call ENCC 86 
End Courtesy Call ENCC 117 
End Courtesy Call ENCC 129 
End Courtesy Call ENCC 156 
End Courtesy Call ENCC 159 
End Courtesy Call ENCC 177 
End Courtesy Call ENCC 196 
End Courtesy Call ENCC 200 
End Courtesy Call ENCC 217 
End Courtesy Call ENCC 220 
End Courtesy Call ENCC 229 
End Courtesy Call ENCC 239 
End Courtesy Call ENCC 242 
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END 


END 


ENT 


ENT 


ENT 
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End Courtesy Call ENCC 
End Courtesy Call ENCC 
End Courtesy Call ENCC 
End Courtesy Call ENCC 
End Courtesy Call ENCC 
End Courtesy Call ENCC 
End Courtesy Call ENCC 
End Courtesy Call ENCC 
End Courtesy Call ENCC 
End Courtesy Call ENCC 
End Courtesy Call ENCC 
End Courtesy Call ENCC 
End Courtesy Call ENCC 
End Courtesy Call ENCC 
End Courtesy Call ENCC 
End Courtesy Call ENCC 


OF QUEUE 

Link I/O to End of Queue LINK 
2 

Extend Size of TSS File ENT2 
RIES 
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-LPRSS Number entries in CALLSS pushdown list 

»~LPRGS Number entries in pushdown list 

-LPRGD Number entries in program descriptor 

»LNDRC Number of entries in DRL count table 

~-LNPD Number of entries in program descriptor list 
»-LNEVT Number of entries in trace table 

PROCESS TSS QUEUE ENTRIES 


RY 

~LLNUE Number of words per UST entry 
.LLWFE Number of words per file table entry 
-LFPES TSS user basic PAT entry size 
FILE ENTRY SPACE ALLOCATION 

Terminate MME GEFINI Entry FINI 
Terminate Error Entry FALT 

SPECIAL ENTRY 

CLEAR UST AND MAKE ACCOUNTING ENTRY 
Conditional MME GEROUT Entry FGROUT 
Special Entry PNTTSX 

File Entry Space Allocation PATMAN 
Special Entry PNTTSX 

UPDATE TO NEXT ENTRY 

ENTRY FROM EXECUTIVE 

Assign an I/O Entry QUEUE 

Process Specific Device Request ENTRY 
File Entry Space Allocation PATMAN 
Special Entry PNTTSX 

Special Entry PNTTSX 
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ENT 


RY (continued) 

Clear UST and Make Accounting Entry TRMCU 
File Entry Space Allocation PATMAN 

Clear UST and liake Accounting Entrv TRMCU 
File Entry Space Allocation PATNAN 
Special Entry PNTTSX 

Process Specific Device Request ENTRY 
File Entry Space Allocation PATHAN 

ENTRY FROM GECOS 

Derail Entry From Executive EXDRL 

Special Entry PNTTSX 

Clear UST and liake Accounting Entry TRMCU 
Process Specific Device Request ENTRY 
Assign An I/O Entry QUEUE 

Terminate Error Entry FALT 


ERROR 
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SYSTEM ERROR (TSSF) 

SYSTEM ERROR 

ERROR (EP1 of TSSF) 
Terminate Error Entry FALT 
EXECUTIVE ERROR MESSAGES (TSSG) 
PRINT ERROR MESSAGE 

System Error ERROR 

Print Error Message PNTERR 
System Error ERROR 

Print Error liessage PNTERR 
Print Error liessage PNTERR 
Print Error liessage PNTERR 
Print Error Hessage PNTERR 
Print Error Message PNTERR 
System Error ERROR 

Print Error liessage PNTERR 
Print Error Message PNTERR 
Print Error Message PNTERR 
Print Error Message PNTERR 
Print Error Message PNTERR 
Print Error liessage PNTERR 
Print Error Hessage PNTERR 
Print Error Message PNTERR 
System Error ERROR 

Print Error liessage PNTERR 
System Error ERROR 

System Error ERROR 

Print Error liessage PNTERR 
System Error ERROR 
Terminate Error Entry FALT 
ERROR MESSAGES 
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ERRORS 
~LRMAX Number of system errors allowed before abort 7 
SYSTEM ERRORS 269 
SUBSYSTEM ERRORS 269 
EVENTS 
TRACE OF EVENTS (TSSB) 16 
TRACE RECENT EVENTS Ne 
Trace Recent Events TSEVNT 57 
Trace Recent Events TSEVNT 64 
Trace Recent Events TSEVNT 67 
Trace Recent Events TSEVNT 69 
Trace Recent Events TSEVNT 71 
Trace Recent Events TSEVNT 73 
Trace Recent Events TSEVNT 86 
Trace Recent Events TSEVNT 229 
EXCEED 
-LSZTM Size and Time exceed fault 8 
EXDRL 
EXDRL (EP1 of TSSK) 97 
Derail Entry From Executive EXDRL 239 
EXEC 
BXEC primitive 254 
EXECUTION 
Return to Subsystem Execution RETSSX 230k 
RETURN TO SUBSYSTEM EXECUTION 243 
EXECUTIVE 
SUBPROGRAM DESCRIPTIONS (EXECUTIVE) 5 
Time-Sharing Executive (.MTIMS) module 5 
~-LNTSF Number of TSS executive files 7 
EXECUTIVE ERROR MESSAGES (TSSG) 45 
Executive Disc I/O TSXDIO 87 
ENTRY FROM EXECUTIVE 97 
EXECUTIVE DISC I/O 101 
Executive Disc I/O TSXDIO 156 
Executive Disc I/O TSXDIO 159 
Executive Disc I/O TSXDIO ea? 
Executive Disc I/O TSXDIO 220 
EXECUTIVE SUBPROGRAM (TSSM) 236 
Derail Entry From Executive EXDRL 239 
Executive Disc I/O TSXDIO z39 
EXENTR 
EXENTR (EP1 of TSSM) 237 
EXIT 
TSS EXIT (TSSE) 37 
EXTEND 
Extend Size of TSS File ENT2 196 
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EXTSQ 


Line Service Ch 
EXTSQ 7 


FAKEIN 


(mp) 
{lire 


ec 
me 
of TSS 


k 
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1 
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FAKEIN (DRL PSEUDO, TSSK) 


FALT 
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Error 
Error 
Error 
Error 
Error 
Error 
Error 
Error 


Message 
Message 
Message 
Message 
Message 
Message 
Message 
Message 
Message 
Message 


PNTERR 
PNTERR 
PNTERR 
PNTERR 
PNTERR 
PNTERR 
PNTERR 
PNTERR 
PNTERR 
PNTERR 
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PNTERR (continued) 


pe SS SS ee oe oe Pe were ek § 


PNTTSX 


Error 
Error 
Error 
Error 
Error 


Message 
Kiessage 
Message 
Message 
Message 


PNTTSX (EP2 of TSSG) 


Special 
Special 
Special 
Special 
Special 
Special 


POINTER 
- LBACK 
. LFLAG 
. LFILE 
- LSFTM 
LBPTR 
-LOCLP 


. TAREA 


POOL 
Return 
Return 
Return 
Return 


POPUP 
POPUP 


PPT 
-LTDES 


PPTCC1L 
PPTCC1 


PPTOFF 


Entry 
Entry 
Entry 
Entry 
Entry 
Entry 


PNTTSX 
PNTTSX 
PNTTSX 
PNTTSX 
PNTTSX 
PNTTSX 


PNTERR 
a at 


a oP a aN 


PNTERR 
PNTERR 
PNTERR 
PNTERR 
PNTERR 
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Backward pointer priority value 
Forward pointer flags 
Pointer to program stack and AFT 
4-word LINSRV pointer disc/drum R/W 
DATANET 760 buffer pointer 


Line Service previous current line pointer 


1 Pointers for TSSO 


LINKS/LLINKS 
LINKS /LLINKS 
LINKS /LLINKS 
Links /Llinks 


to the 
to the 
to the 
to the 


File description of 


function of TSSJ 
Paper Tape Courtesy Call PPTCC1 
Paper Tape Courtesy Call PPTCCl 


use, 


Pool 
Pool 
Pool 
Pool 


PPT 


initialization. 


ONE 
ONE 
ONE 
ONE 


Send "Stop Paper Tape" to DATANET PPTOFF 
Send "Stop Paper Tape" to DATANET PPTOFF 


PPTOFF/PPTERM 
PPTOFF/PPTERM (DRL STOPPT) 
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PRIMITIVE 


primitive 
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Summary of Primitive Actions 
INTERPRET PRIMITIVE 
Interpret Primitive 
Interpret Primitive 
Interpret Primitive 
EXEC primitive 


PRINT 


PRINT ERROR 
Print Error 
Print Error 
Print Error 
Print Error 
Print Error 
Print Error 
Print Error 
Print Error 
Print Error 
Print Error 
Print Error 
Print Error 
Print Error 
Print Error 
Print Error 
Print Error 


PRIORITY 
-LTIO Priority I/O this interaction 
-LBACK Backward pointer priority value 


PRI 


VILEGED 


MESSAGE 
Message 
Message 
Message 
Message 
Message 
Message 
Message 
Message 
Message 
hiessage 
Message 
Message 
Message 
Message 
Message 
Message 


SCAN 3 
SCAN3 
SCAN 3 


PNTERR 
PNTERR 
PNTERR 
PNTERR 
PNTERR 
PNTERR 
PNTERR 
PNTERR 
PNTERR 
PNTERR 
PNTERR 
PNTERR 
PNTERR 
PNTERR 
PNTERR 
PNTERR 


-LACPT Accept indicator for privileged subsystem 
PRIVILEGED DISC I/O 


PROCESSES 
CONTROL OF USER PROCESSES 
TSSH (Control of User Processes) 


PROCESSOR TIME 
-LSTP Sum of user processor time 

.LTP Processor time this interaction 

-LTPSS Processor time at subsystem start 

-LSPTS Sum of processor time this subsystem interaction 
-LSPRT Sum of processor time in subsystem 

OBTAIN PROCESSOR TIME, DATE, TIME OF DAY 


PROCESSORS 
DERAIL PROCESSORS (TSSK) 
TSSK (Derail Processors) 
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(TSSH) 


of 
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oe) 


60 
75 
87 
124 
254 


47 

64 
117 
129 
136 
144 
156 
Tel 


17% 
LOO 


165 
177 
207 
217 
220 
223 
229 
230 


OO 


PROGRAM DESCRIPTOR 


TDPRAN Number antr 


Program 
program 
Program 
Program 
Program 
Program 


PSEUDO 


Descriptor 
descriptor 
Descriptor 
Descriptor 
Descriptor 
Descriptor 


f4- 


for BASIC 
for EDIT 
For LIST 
Name table 


FAKEIN (DRL PSEUDO, TSSK) 


PUSHDOWN 


~LCALS CALLSS 
-LPRSS Number 
-LPRGS Number 
pushdown list 


pushdown list 

entries in CALLSS pushdown list 
entries in pushdown list 
(called program stack) 


QUEUE 
Update 
Update 
Update 
Update 
Update 


eee ae ae 
MALLOY 


Allocator Queue 
Allocator Queue 
Allocator Queue 
Aliocator Q 
Allocator Q 


GCSES Yucur 


new user queue 
Allocate Job in Queue ALLOCI 


Update 
Update 
Assign 
Update 
Update 
Update 
Update 
Update 
Update 
Update 
Update 
Update 
Update 
Update 
Update 
Update 
Update 
Update 
Update 
Update 
Update 
UPDATE 


Queue 


ALLOC 
ALLOC 
ALLOC 
ALLUC 


ALLOC 


ue Ue 
ueue 


Allocator Queue ALLOC 
Allocator Queue ALLOC 
an I/O Entry QUEUE 

Allocator Q 
Allocator Q 
Allocator Q 
Allocator Q 
Allocator Q 
Allocator Q 
Allocator Q 
Allocator Q 
Allocator Q 
Allocator Q 
Allocator Q 
Allocator Q 
Allocator Q 
Allocator 
Allocator Q 
Allocator Q 
Allocator Q 
Allocator Q 
ALLOCATOR Q 


ALLOC 
ALLOC 
ALLOC 
ALLOC 
ALLOC 
ALLOC 
ALLOC 
ALLOC 
ALLOC 
ALLOC 
ALLOC 
ALLOC 
ALLOC 
ALLOC 
ALLOC 
ALLOC 
ALLOC 
ALLOC 


ueue 
ueue 
ueue 
ueue 
ueue 
ueue 
ueue 
ueue 
ueue 
ueue 
ueue 
ueue 
ueue 


ueue 
ueue 
ueue 
ueue 
UEUE 


ALLOCATE JOB IN QUEUE 

Update the Allocator Queue ALLOC 
PROCESS TSS QUEUE ENTRIES 

Assign An I/O Entry QUEUE 
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QUEUES 
-~LSNIO Number of I/O queues for TSS 7 
READ 
READ / WRITE CORE FILE 143 
REASON 
-LBRT Location of abort, reason code 7 
RECENT 
TRACE RECENT EVENTS 17 
Trace Recent Events TSEVNT 57 
Trace Recent Events TSEVNT 64 
Trace Recent Events TSEVNT 67 
Trace Recent Events TSEVNT 69 
Trace Recent Events TSEVNT 71 
Trace Recent Events TSEVNT 73 
Trace Recent Events TSEVNT 86 
Trace Recent Events TSEVNT 229 
REGION 
Program Descriptor Region 15 
REGISTER 
~-LOSTR Offset for subsystem register 8 
REJECT 
SYSTEM LOADED - REJECT NEW USER 90 
RELEASE 
RELEASE #S LINKS 26 
Release #S Links RELSPC 86 
RELEASE A FILE Leacy. 
RELEASE MEMORY 139 
Release Buffer TERM76 167 
Release UST RUST 167 
PARTIAL RELEASE OF TEMPORARY FILES 193 
Partial Release of Mass Storage File CALL 194 
Memory Release for Time~Sharing GMRLM 233 
Release UST RUST 250 
RELEASE UST 251 
RELEASE BUFFER 259 
RELINQUISH 
Relinquish Control Until Program Enabled DSCNT 86 
Relinquish RLC 117 
Relinguish RLC 159 
Relinquish RLC 220 
Relinquish RLC 229 
Relinquish RLC 248 
Relinquish RLC 263 
Relinquish Control Until Program Enabled DSCNT 263 
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RELMEM (DRL RELMEM, TSSK) 


RELS 
LIME GERELS Processor RELS 
MME GERELS Processor RELS 


RELSPC 
RELSPC (EP3 of TSSC) 
Release #S Links RELSPC 


REMOTE 
-LTTYS Remote status return word 
Initiate Remote I/O KEYIO 
INITIATE REMOTE 1/0 
Initiate Remote I/O KEYIO 
PASS FILE TO REMOTE BATCH PROCESSOR 


REQUEST 
REQUEST DRUM SPACE 
Additional Mass Storage Request MINK 
Accounting File Request ACTFL 
Process Specific Device Request ENTRY 
Additional Mass Storage Request MINK 
BATCH OUTPUT REQUEST 
Process Specific Device Request ENTRY 
Reyguest oful Space voihore 
Request Drum Space DRMSPC 
Request Drum Space DRMSPC 
Process Specific Device Request ENTRY 


REQUESTS 
PERMANENT FILE REQUESTS 


RESET 
RESET SWITCH WORD 
Reset Flags and Indicators NEWU76 
Reset BAR to Smaller Area FLBAR 
Reset BAR to Smaller Area FLBAR 
RESET FLAGS AND INDICATORS 


RESTOR 
RESTOR (DRL RESTOR, TSSK) 


RETFIL 
DRLRFL (DRL RETFIL, TSSK) 


RETRIEVE 
RETRIEVE LAST LINE OF INPUT 
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132 
173 
239 
245 
258 


155 


L37 


Lad 
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RETSBS 


Return 
RETSBS 
Return 
Return 
Return 
Return 
Return 
Return 
Return 


RETSPC 


RETSPC 
Return 


RETSSX 


Return 
RETSSX 


RETU RN 


REW 


eLCC Courtesy call return 


RETURN 
Return 
Return 
RETURN 
Return 
RETURN 
Return 
Return 
RETU RN 
DRLRET 
Return 
Return 
Return 
Return 
RETURN 
Return 
Return 
Return 
Return 
Return 
RETURN 


DRLREW 


REWIND 
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REWIND 


to Subsystem from 


(EP2 of TSSK) 


to 
to 
to 
to 
to 
to 
to 


(EP2 of TSSC) 


Subsystem 
Subsystem 
Subsystem 
Subsystem 
Subsystem 
Subsystem 
Subsystem 


from 
from 
from 
from 
from 
from 
from 


Drum Space RETSPC 


Derail 


Derail 
Derail 
Derail 
Derail 
Derail 
Derail 
Derail 


RETSBS 


RETSBS 
RETSBS 
RETSBS 
RETSBS 
RETSBS 
RETSBS 
RETSBS 


to Subsystem Execution RETSSX 


(EP3 of TSSM) 


DRUM SPACE 
LINKS /LLINKS 
LINKS /LLINKS 


to 
TO 
to 
to 


Subsystem 
SUBSYSTEM 
Subsystem 
Subsystem 


to the Pool 
to the Pool 


from 
FROM 
from 
from 


FROM SUBSYSTEM 


(DRL RETURN, TSSK) 


LINKS /LLINKS 


to 
to 
to 
TO 
to 
to 


Subsystem 
Subsystem 
Subsystem 


Derail 
DERAIL 
Derail 
Derail 


to the Pool 


from 
from 
from 


SYSTEM MODE 


Subsystem 
Subsystem 


from 
from 


Derail 
Derail 
Derail 


Derail 
Derail 


Links/Llinks to the Pool 
Drum Space RETSPC 
to Subsystem Execution RETSSX 
TO SUBSYSTEM EXECUTION 


(DRL REW, TSSK) 


FILE 


ONE 
ONE 


RETSBS 


RETSBS 
RETSBS 


ONE 

RETSBS 
RETSBS 
RETSBS 


RETSBS 
RETSBS 
ONE 
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RLC 
Relinguish RLC 
Relingquish RLC 
Relinquish RLC 
Relinguish RLC 
Relinguish RLC 


Relinquish RLC 


ROADBLOCK 
Roadblock GRD 


ROUTINES 
UTILITY ROUTINES (TSST) 
TSS STARTUP ROUTINES (TSSO) 


RS TSWH 
DRLRST (DRL RSTSWH, TSSK) 


RTNCM 
RTNCM, in Line Service 


RUST 
Release UST RUST 
Release UST RUST 


- SAVE PROGRAMS ON PERM FILE 
SAVE (DRL SAVE) 


SCAN 
SCAN FOR CONTROL LANGUAGE 
SCAN FOR KNOWN COMMAND WORD 
Scan for Control Language SCAN1 
Scan for Known Command Word SCAN2 


SCANI1 
SCAN1 (EP1 of TSSH) 
Scan for Control Language SCAN1 


SCAN2 
SCAN2 (EP2 of TSSH) 
Scan for Known Command Word SCAN2 


SCAN 3 
SCAN3 (EP3 of TSSH) 
Interpret Primitive SCAN3 
Interpret Primitive SCAN3 
Interpret Primitive SCAN3 


SCK 
Set Alarm SCK 
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248 
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65 
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SCRATCH 

-LBKMX Block number threshold for scratch file 7 
SEARCH 

Search the AFT SRCH 102 

SEARCH THE AFT 111 

Search the AFT SRCH 117 

Search the AFT SRCH 129 

Search the AFT SRCH 136 

Search the AFT SRCH 138 

Search the AFT SRCH 156 

Search the AFT SRCH 159 

Search the AFT SRCH 161 

Search the AFT SRCH 171 

Search the AFT SRCH 177 

Search the AFT SRCH 194 

Search the AFT SRCH 196 

Search the AFT SRCH 202 

Search the AFT SRCH 217 

Search the AFT SRCH 220 

Search the AFT SRCH 239 
SELECTION 

File System Initialization and Module Selection FSINIT 263 
SEND 

Send "Stop Paper Tape" to DATANET PPTOFF 44 

Send "Stop Paper Tape" to DATANET PPTOFF 50 

SEND "STOP PAPER TAPE" TO DATANET 214 
SERVICE 

Line Service LINSRV 207 

Line Service LINSRV 209 
SET ALARM 

Set Alarm SCK 86 
SETLNO 

SETLNO (DRL SETLNO, TSSK) 178 
SETSWH 

DRLSET (DRL SETSWH, TSSK) 130 
SETTING 

-LBRTM GELBAR time setting 8 
SIMULATED 

SIMULATED KEYBOARD INPUT 221 
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SIZE 


~LSIZE Base in TSS size in core 
~LSWAP Block No. 


on drum actual size 
.LFPES TSS user basic PAT entry size 


-LPSZ Size of subsystem patch area 
-LSZTM Size and Time exceed fault 

Core Size Adjustment ALL7AC 
INCREASE PERM FILE TO MAXIMUM SIZE 
Extend Size of TSS File ENT2 
TIME AND SIZE LIMIT 
PROCESSOR TIME AND CORE SIZE LIMIT 


Installation core size and processor time limits 


Core Size Adjustment ALL7AC 
CORE SIZE ADJUSTMENT 


SLAVE 


Let Slave Program 
Let Slave Program 


SLAVE PROGRAM 


Let 
Let 
Let 
Let 
Let 
Let 
Let 
Let 
Let 
Let 
Let 
Let 
Let 
Let 
Let 
Let 
Let 
Let 
Let 
Let 
Let 
Let 
Let 
Let 
Let 
Let 
Let 
Let 


Slave 
Slave 
Slave 
Slave 
Slave 
Slave 
Slave 
Slave 
Slave 
Slave 
Slave 
Slave 
Slave 
Slave 
Slave 
Slave 
Slave 
Slave 
Slave 
Slave 
Slave 
Slave 
Slave 
Slave 
Slave 
Slave 
Slave 
Slave 


SNAPSHOT 


Obtain 
Obtain 
Obtain 


Program 
Program 
Program 
Program 
Program 
Program 
Program 
Program 
Program 
Program 
Program 
Program 
Program 
Program 
Program 
Program 
Program 
Program 
Program 
Program 
Program 
Program 
Program 
Program 
Program 
Program 
Program 
Program 


Enter 
Enter 


Enter 
Enter 
Enter 
Enter 
Enter 
Enter 
Enter 
Enter 
Enter 
Enter 
Enter 
Enter 
Enter 
Enter 
Enter 
Enter 
Enter 
Enter 
Enter 
Enter 
Enter 
Enter 
Enter 
Enter 
Enter 
Enter 
Enter 
Enter 


Master 
Master 


Master 
Master 
Master 
Master 
Master 
Hlaster 
Master 
Master 
Master 
Master 
Master 
Master 
Master 
Master 
Master 
Master 
Master 
Master 
Master 
Master 
Master 
Master 
Master 
Master 
Master 
Master 
Master 
Master 


Normal Snapshot GESNIP 
Normal Snapshot GESNIP 
Normal Snapshot GESNIP 


Mode 
Mode 


Mode 
Mode 
Mode 
Mode 
Mode 
Mode 
Mode 
Mode 
Mode 
Mode 
Mode 
Mode 
Mode 
Mode 
Mode 
Mode 
Mode 
Mode 
Mode 
Mode 
Mode 
Mode 
Mode 
Mode 
Mode 
Mode 
Mode 
Mode 


FEMM 
FEMM 


FEMM 
FEMM 
FEMM 
FEMM 


FEMM 


aus ais 


FEMM 
FEMM 
FEMM 
FEMM 
FEMM 
FEMM 
FEMM 
FEMM 
FEMM 
FEMM 
FEMM 
FEMM 
FEMM 
FEMM 
FEMM 
FEMM 
FEMM 
FEMM 
FEMM 
FEMM 
FEMM 
FEMM 
FEMM 
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SNUMB 


-~LSNUB SNUMB of batch job waiting 
OBTAIN SNUMB 


SPACE 


available space chain 

ENTRY SPACE ALLOCATION 
Entry Space Allocation 
Entry Space Allocation 
Entry Space Allocation 
Entry Space Allocation 


FILE 
File 
File 
File 
File 


PATMAN 
PATMAN 
PATMAN 
PATMAN 


SWITCH NAMES ASSIGNED TO TEMPORARY 
Entry Space Allocation PATMAN 


File 


SPACING 
FILE 
File 
File 
File 
File 


SPACING 
Spacing 
Spacing 
Spacing 
Spacing 


TSXSPF 
LOASPE 
TSXSPF 
TSXSPF 


SPAWN 


PASFIL (DRL SPAWN, TSSK) 


SPAWN A SPECIAL BATCH ACTIVITY 


SPECIAL 


SPECIAL 
Special 
Special 
Special 
Special 
Special 
SPAWN A 
Special 


SRCH 
Search the AFT SRCH 
SRCH (EP8 of TSSK) 
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Search 
Search 
Search 
Search 
Search 
Search 
Search 
Search 
Search 
Search 
Search 
Search 
Search 
Search 
Search 


ENTRY 
Entry 
Entry 
Entry 
Entry 
Entry 


PNTTSX 
PNTTSX 
PNTTSX 
PNTTSX 
PNTTSX 


SPECIAL BATCH ACTIVITY 


Entry 


the 
the 
the 
the 
the 


AFT 
AFT 
AFT 
AFT 
AFT 
AFT 
AFT 
AFT 
AFT 
AFT 
AFT 
AFT 
AFT 
AFT 
AFT 


PNTTSX 


SRCH 
S RCH 
SRCH 
SRCH 
SRCH 
SRCH 
SRCH 
S RCH 
S RCH 
SRCH 
SRCH 
S RCH 
SRCH 
S RCH 
SRCH 
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FILE SPACE 


STACK 
-LFILE Pointer to program stack and AFT 
pushdown list (called program stack) 


START 
-LTPSS Processor time at subsystem start 
~LKYSS Key 1/0 count at subsystem start 
~LDCSS Disc I/O count at subsystem start 
»-LKEYO Time of Key I/O start 


STARTP 
TSS Subsystem Startup STARTP 
STARTP (EP5 of TSSI) 
TSS Subsystem Startup STARTP 
TSS Subsystem Startup STARTP 


STARTUP 
TSS Subsystem Startup STARTP 
TSS SUBSYSTEM STARTUP 
TSS Subsystem Startup STARTP 
TSS Subsystem Startup STARTP 
TSS STARTUP ROUTINES (TSSO) 
TIME-SHARING SYSTEM STARTUP 


TION 


~LBUF Buffer B* T* station ID 


STATUS 
-LIOST I/O status - disc-remote 
-LTSSV Saved I/O status 
-LFTST Accumulated fault status 
.-LASTT Swap I/O status - 2 words 
User Status Table 
GET JOB STATUS 
User Status Tables (UST) 


STATUS RETURN 
-LTTYS Remote status return word 


STBTAL 
Set Tally for Output Buffer STBTAL 
STBTAL (EP5 of TSSK) 
Set Tally for Output Buffer STBTAL 
Set Tally for Output Buffer STBTAL 


STFALS 
STFALS 


STGIO 
STGIO function of TSSJ 
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STOBUF 
Transmit Data to Buffer STOBUF 
STOBUF (EP6 of TSSK) 
Transmit Data to Buffer STOBUF 
Transmit Data to Buffer STOBUF 


STOP 
Send "Stop Paper Tape" to DATANET PPTOFF 
Send "Stop Paper Tape" to DATANET PPTOFF 
STOP A MASTER SUBSYSTEM 
SEND "STOP PAPER TAPE" TO DATANET 


STOPPT 
PPTOFF/PPTERM (DRL STOPPT) 


STPSYS 
STPSYS (DRL STPSYS, TSSK) 


STRUE 
STRUE 


SUBPROGRAM 
SUBPROGRAM DESCRIPTIONS (EXECUTIVE) 
EXECUTIVE SUBPROGRAM (TSSM) 


SUBSYSTEM 
-LTPSS Processor time at subsystem start 
-LKYSS Key I/O count at subsystem start 
-LDCSS Disc I/O count at subsystem start 
-LSPTS Sum of processor time this subsystem interaction 
~LSPRT Sum of processor time in subsystem 
- LIMIT Subsystem time limit set by user 
-LACPT Accept indicator for privileged subsystem 
-LPSZ Size of subsystem patch area 
-LOSTI Offset for subsystem indicators 
.-LOSTR Offset for subsystem register 
TSS Subsystem Startup STARTP 
TSS SUBSYSTEM STARTUP 
TSS Subsystem Startup STARTP 
Return to Subsystem from Derail RETSBS 
RETURN TO SUBSYSTEM FROM DERAIL 
Return to Subsystem from Derail RETSBS 
Return to Subsystem from Derail RETSBS 
Pass AFT to a Subsystem PASAFT 
RETURN FROM SUBSYSTEM 
Return to Subsystem from Derail RETSBS 
Return to Subsystem from Derail RETSBS 
PASS AFT TO A SUBSYSTEM 
OVERLAY - LOAD A SUBSYSTEM OR PERM FILE 
Return to Subsystem from Derail RETSBS 
INTERNAL CALL TO ANOTHER SUBSYSTEM 
TSS Subsystem Startup STARTP 
PASS UST TO SUBSYSTEM 
STOP A MASTER SUBSYSTEM 
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Return to Subsystem from Deraili RETSBS 207 
Return to Subsystem from Derail RETSBS 209 
Pass AFT to Subsystem PASAFT 209 
ALLOCATION AND DISPATCH OF SUBSYSTEM PROGRAMS (TSSL) 224 
Return to Subsystem Execution RETSSX 231 
RETURN TO SUBSYSTEM EXECUTION 243 
SUBSYSTEM ERRORS 269 
SUM 
-LSTP Sum of user processor time 6 
-LSPTS Sum of processor time this subsystem interaction 7 
~LSPRT Sum of processor time in subsystem - 
SUMMARY 
Summary of Primitive Actions 53 
SWAP 
Swap courtesy call by user 6 
~LTPS .LTP at last swap 7 
-~LTIOS .LTIO at last swap 7 
.~LADCW Miax. number swap DCW's 7 
-LASTT Swap I/O status - 2 words 8 
»~LADW1 Swap DCWl and biock number cell 8 
Set Up For Swap SWAP 229 
set Up For Swap SWAP 251 
Set Up for Swap SWAP 233 
SET UP FOR SWAP 234 
SWAP (EP4 of TSSL) 234 
Set Up for Swap SWAP 248 
SWAP CORE 
Swap core file 246 
SWAP SPACE 
SWAP SPACE ALLOCATOR (TSSC) 21 
SWITCH 
SWITCH FILE NAMES 113 
PROCESS LINE SWITCH 191 
SWITCH NAMES ASSIGNED TO TEMPORARY FILE SPACE 201 
DRLSWH (DRL SWITCH, TSSK) 201 
SWITCH WORD 
-LSWTH Switch word for user 6 
switch word (.LSWTH) 5S 
SET SWITCH WORD 130 
RESET SWITCH WORD 132 
SYMAN 
SYMAN (EP6 of TSSI) 76 
Input Collector File Space Manager SYMAN 248 
Input Collector File Space Manager SYMAN 252 
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SYS 


SYS 


SYS 


TAB 
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System Nessage Generator SYS 
System Message Generator SYS 
SYS (EP4 of TSSTI) 

Message Generator SYS 
Message Generator SYS 
liessage Generator SYS 
Liessage Generator SYS 


System 
System 
System 
System 


RET 
SYSRET 


TEM 


(DRL SYSRET, TSSK) 


Time-Sharing System Flow of Control 
Number of system errors allowed before abort 
ERROR (TSSF) 


.« LRMAX 
SYSTEM 
SYSTEM 
System 
System 
System 
SYSTEM 
System 
System 
System 
SYSTEM 
System 
System 
RETURN 
System 
System 
System 
System 
system 


ERROR 


Message Generator SYS 


Error 


ERROR 


Message Generator SYS 
MESSAGE GENERATOR 
Message Generator SYS 


Error 


ERROR 


Message Generator SYS 
LOADED - REJECT NEW USER 


Error 


ERROR 


Message Generator SYS 
TO SYSTEM MODE 
Message Generator SYS 


Error 
Error 
Error 
Error 


TIME-SHARING 


File System Initialization and Module Selection FSINIT 
SYSTEM MACROS 


ERROR 
ERROR 
ERROR 
ERROR 
SYSTEM STARTUP 


TIME-SHARING SYSTEM DECK SETUP AND MEMORY LAYOUT 


SYSTEM ERRORS 


LE 
-LFILS 


Max. 


number of entries in file table 


~LNDRC Number of entries in DRL count table 
-LLWFE Number of words per file table entry 
~LNEVT Number of entries in trace table 
trace table 
Available File Table (AFT) 
Peripheral Assignment Table (PAT) 
User Status Table 

User Status Table 

Transfer Vector Table 


- CRSNB 


table 


Program Descriptor Name table 


TABLES 
User Status Tabies 


TALK 
MASTER TTY/600 CONSOLE TALK 


TALLY 
Set Tally for Output Buffer 
SET TALLY FOR OUTPUT BUFFER 
Set Tally for Output Buffer 
Set Tally for Output Buffer 


STBTAL 


STBTAL 
STBTAL 


TAPE 
Paper Tape Courtesy Call PPTCC1l 


TAPEIN 
DRLPPT (DRL TAPEIN, TSSK) 


TAPE" 
Send "Stop Paper Tape" 
Send "Stop Paper Tape" 


to 
to 


DATANET PPTOFF 
DATANET PPTOFF 


SEND "STOP PAPER TAPE" TO DATANET 
TASK 

TASK (DRL TASK) 
TEMPORARY 


DEFINE A TEMPORARY FILE 
ADD LINKS TO TEMPORARY FILE 
PARTIAL RELEASE OF TEMPORARY FILES 


SWITCH NAMES ASSIGNED TO TEMPORARY FILE SPACE 


TERM 
TERM (EP1 of TSSI) 
Terminate Routine TERM 
Terminate Routine TERM 
TERM 


TERM 76 
Release Buffer TERM76 
TERM76 function of TSSO 


TERMINAL 
~LSTIO No. char/8 to terminal No. 
TERMINAL TYPE 
DISCONNECT TERMINAL 


file I/O 


TERMINATE 
-LTRM Terminate courtesy call 
Terminate IiME GEFINI Entry FINI 
Terminate Error Entry FALT 
TERMINATE ROUTINE 
USER TERMINATE 
Terminate Routine TERM 
Terminate Routine TERM 
Terminate Error Entry FALT 
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TERMINATION 

Termination 83 
TERMINATIONS 

Processing Keyboard I/O Terminations 79 
TE RMPG 

TERMPG (DRL TERMPG, TSSK) 166 
TERMTP 

TERMTP (DRL TERMTP, TSSK) 151 
TEXT 

Message Text 45 
THRESHOLD 

»-LBKMX Block number threshold for scratch file 7 
TIME 

~LKEYO Time of Key I/O start 7 

- LIMIT Subsystem time limit set by user 7 

-LIMTR Time limit timer a 

-LSZTM Size and Time exceed fault 8 

.LBRTM GELBAR time setting 8 

TIME (DRL TIME, TSSK) 147 

TIME AND SIZE LIMIT 203 

PROCESSOR TIME AND CORE SIZE LIMIT 210 

Installation core size and processor time limits 211 

User-specified processor time limit 211 

installation time limit 211 

user time limit 211 
TIME OF DAY 

-LTIN Time of day this interaction started 6 

»~LTALC Time of day user entered TSS 6 

Provide Date and Time of Day FGTIM 20 

Provide Date and Time of Day FGTIM 86 

OBTAIN PROCESSOR TIME, DATE, TIME OF DAY 147 

Provide Date and Time of Day FGTII 148 

Provide Date and Time of Day FGTIM 220 

Provide Date and Time of Day FGTIli 263 
TIMER 

~LIMTR Time limit timer 7 
TRACE 

»~LNEVT Number of entries in trace table 7 

TRACE OF EVENTS (TSSB) 16 

TRACE RECENT EVENTS 17 

trace table 18 

Trace Recent Events TSEVNT at 
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TRACE (continued) 


Trace Recent Events TSEVNT 64 
Trace Recent Events TSEVNT 67 
Trace Recent Events TSEVNT 69 
Trace Recent Events TSEVNT 71 
Trace Recent Events TSEVNT 73 
Trace Recent Events TSEVNT 86 
Trace Recent Events TSEVNT 229 
TRANSFER VECTOR 
Transfer Vector Table 95 
TRANSMIT 
Transmit Data to Buffer STOBUF 50 
TRANSMIT DATA TO BUFFER 107 
Transmit Data to Buffer STOBUF 119 
Transmit Data to Buffer STOBUF 209 
TRMCU 
TRMCU (EP2 of TSSTI) 68 
Clear UST and Make Accounting Entry TRMCU 167 
Clear UST and Make Accounting Entry TRMCU 173 
Clear UST and Make Accounting Entry TRMCU 250 
TSEVNT 
MOAT UAT fon? - FF NOC \ ear) 
ade wad yete Ve LOUD; af 
Trace Recent Events TSEVNT 57 
Trace Recent Events TSEVNT 64 
Trace Recent Events TSEVNT 67 
Trace Recent Events TSEVNT 69 
Trace Recent Events TSEVNT 71 
Trace Recent Events TSEVNT 73 
Trace Recent Events TSEVNT 86 
Trace Recent Events TSEVNT 229 
TSFIN 
TSFIN (EP1 of TSSE) 38 
TSSA 
COMMUNICATION REGION (TSSA) 6 
Communication Region (TSSA) 23 
TSSA (Communication Region) 254 
TSSB 
TRACE OF EVENTS (TSSB) 16 
TSEVNT (EP1 of TSSB) 17 
TSSC 
SWAP SPACE ALLOCATOR (TSSC) 21 
DRMSPC (EP1 of TSSC) 22 
RETSPC (EP2 of TSSC) 24 
RELSPC (EP3 of TSSC) 26 


327 


TSSD 
PAT MANAGER (TSSD) 
PATMAN (EP1 of TSSD) 
PATDEA (EP2 of TSSD) 
FREE (EP3 of TSSD) 


TSSE 
TSS EXIT (TSSE) 
TSFIN (EP1 of TSSE) 


TSSF 
SYSTEM ERROR (TSSF) 
ERROR (EP1 of TSSF) 


TSSG 
EXECUTIVE ERROR MESSAGES (TSSG) 
PNTERR (EP1 of TSSG) 
PNTTSX (EP2 of TSSG) 


TSSH 
CONTROL OF USER PROCESSES (TSSH) 
SCAN1 (EP1l of TSSH) 

SCAN2 (EP2 of TSSH) 
SCAN3 (EP3 of TSSH) 


TSSH (Control of User Processes) 


TSSI 
UTILITY ROUTINES (TSSTI) 
TERM (EP1 of TSSI) 
TRMCU (EP2 of TSSI) 
KEYIO (EP3 of TSST) 
SYS (EP4 of TSSI) 
STARTP (EP5 of TSSI) 
SYMAN (EP6 of TSSI) 


TSSJ 
LINE SERVICE (TSSJ) 
LINSRV (EP1 of TSSJ) 
MONCK (EP2 of TSSJ) 
LDED function of TSSJ 
GOOD10 function of TSSJ 
UPDAT function of TSSJ 
STGIO function of TSSJ 
PPTCC1]1 function of TSSJ 
TSSJ (Line Service) 


TSSK 
DERAIL PROCESSORS (TSSK) 
EXDRL (EP1 of TSSK) 
RETSBS (EP2 of TSSK) 
TSXDIO (EP3 of TSSK) 
BUFDMP (EP4 of TSSK) 
STBTAL (EP5 of TSSK) 
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TSSK (continued) 


STOBUF (EP6 of TSSK) 107 
TSXSPF (EP7 of TSSK) 109 
SRCH (EP8 of TSSK) 111 
TSXSWH (EP9 of TSSK) 113 
DRLDIO (DRL DIO, TSSK) 115 
DRLKOT (DRL KOUT, TSSK) 118 
DRLKON (DRL KOUTN, TSSK) 120 
DRLKIN (DRL KIN, TSSK) 121 
DRLRET (DRL RETURN, TSSK) 123 
DRLFIL (DRL DEFIL, TSSK) 125 
DRLABT (DRL ABORT, TSSK) 128 
DRLSET (DRL SETSWH, TSSK) 130 
DRLRST (DRL RSTSWH, TSSK) 132 
DRLREW (DRL REW, TSSK) 133 
DRLSPF (DRL FILSP, TSSK) 135 
DRLRFL (DRL RETFIL, TSSK) 137 
RELMEM (DRL RELMEM, TSSK) 139 
ADDMEM (DRL ADDMEM, TSSK) 141 
CORFIL (DRL CORFIL, TSSK) 143 
SNUMB (DRL SNUMB, TSSK) 145 
TIME (DRL TIME, TSSK) 147 
PASAFT (DRL PASAFT, TSSK) 149 
TERMTP (DRL TERMTP, TSSK) isi 
PDIO (DRL PDIO, TSSK) 153 
RESTOR (DRL RESTOR, Tosn) L535 
PASFIL (DRL SPAWN, TSSK) 157 
DRLPPT (DRL TAPEIN, TSSK) 160 
CALLSS (DRL CALLSS, TSSK) 162 
USERID (DRL USERID, TSSK) 164 
TERMPG (DRL TERMPG, TSSK) 166 
PASUST (DRL PASUST, TSSK) 168 
MORLNK (DRL MORLNK, TSSK) 170 
NEWUSR (DRL NEWUSR, TSSK) 172 
FILACT (DRL FILACT, TSSK) 174 
SETLNO (DRL SETLNO, TSSK) 178 
SYSRET (DRL SYSRET, TSSK) 180 
STPSYS (DRL STPSYS, TSSK) 182 
DRLDSC (DRL DRLDSC, TSSK) 184 
PASDES (DRL PASDES, TSSK) 186 
JSTS (DRL JSTS, TSSK) 189 
CGROUT (DRL CGROUT, TSSK) 191 
PART (DRL PART, TSSK) 193 
GROW (DRL GROW, TSSK) 195 
ABTJOB (DRL ABTJOB, TSSK) 197 
CONSOL (DRL CONSOL, TSSK) 199 
DRLSWH (DRL SWITCH, TSSK) 201 
DRLIMT (DRL DRLIMT, TSSK) 203 
OUTNOW (DRL KOTNOW, TSSK) 208 
FAKEIN (DRL PSEUDO, TSSK) 221 
TSSK (Derail Processors) 254 
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TSSL 
TSSL 211 
ALLOCATION AND DISPATCH OF SUBSYSTEM PROGRAMS (TSSL) 224 
ALLOC (EP1 of TSSL) 227 
ALLOCI (EP2 of TSSL) 230 
ALL7AC (EP3 of TSSL) 232 
SWAP (EP4 of TSSL) 234 
TSSL (Allocator) 255 
TSSM 
TSS 211 
EXECUTIVE SUBPROGRAM (TSSM) 236 
EXENTR (EP1 of TSSM) 237 
EXTSQ (EP2 of TSSM) 240 
RETSSX (EP3 of TSSM) 243 
TSSN 
UST GENERATION (TSSN) 246 
DYUST (EP1 of TSSN) 247 
C IST (EP2 of TSSN) 249 
RUST (EP3 of TSSN) 255 
TSSN (Dynamic Ust, DYUST) 255 
TSSO 
-TAREA 1 Pointers for TSSO use, initialization. 13 
TSS STARTUP ROUTINES (TSSO) 253 
GOOD76 function of TSSO 256 
7J60LNO function of TSSO 257 
NEWU76 function of TSSO 258 
TERM76 function of TSSO 259 
KOTB9Y function of TSSO 260 
MAIN (TSSO) 261 
TSTART 
MAIN (TSTART) 253 
MAIN (TSTART 262 
TSXDIO 
Executive Disc I/O TSXDIO 87 
TSXDIO (EP3 of TSSK) 101 
Executive Disc I/O TSXDIO 156 
Executive Disc I/O TSXDIO 159 
Executive Disc I/O TSXDIO 217 
Executive Disc I/O TSXDIO 220 
Executive Disc I/O TSXDIO 239 
TSXSPF 
TSXSPF (EP7 of TSSK) 109 
File Spacing TSXSPF 129 
File Spacing TSXSPF 153 
File Spacing TSXSPF 220 
File Spacing TSXSPF 239 
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mec X¥SwWH 
bw saw 


Waa 


TSXSWH (EP9 of TSSK) 


TTY /600 
MASTER TTY/600 CONSOLE TALK 


TYPRIN 


Process KILL Typein KILL 


Tk 
-LBUF Buffer B* T* station ID 


UNFILLED 
KEYBOARD OUTPUT FROM UNFILLED BUFFER 


UPDAT 
UPDAT function of TSSJ 


UPDATE 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
Update Aliocator Queue ALLOC 
Update Allocator Queue ALLOC 
ENTER NEW USER IN UST AND UPDATE NUG LOUF 
UPDATE TO NEXT ENTRY 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
Update Allocator Queue ALLOC 
UPDATE ALLOCATOR QUEUE 
Update the Allocator Queue ALLOC 
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USER 


-LID User ID 

-LSTP Sum of user processor time 
-LSWTH Switch word for user 

Swap courtesy call by user 

»~LTALC Time of day user entered TSS 
- LIMIT Subsystem time limit set by user 
-LFPES TSS user basic PAT entry size 
~LFPAT Number of TSS user PAT 
CONTROL OF USER PROCESSES (TSSH) 

new user queue 

User Status Table 

New DATANET-760 User GOOD76 

SYSTEM LOADED - REJECT NEW USER 


ENTER NEW USER IN UST AND UPDATE NUQ LOOP 


ABORT USER 

USER IDENTIFICATION 

USER TERMINATE 

LOG=-ON NEW USER WITHOUT DISCONNECT 
user time limit 

User Status Tables (UST) 

TSSH (Control of User Processes) 
NEW DATANET 760 USER 

User GECALL Load Processing MCAL 
USER ACCOUNTING 


USER STATUS 


User Status Table 


USERID 


USERID (DRL USERID, TSSK) 
USERID (DRL USERID, TSSK) 


USERS 


-LLTOT Number of new users per cycle 
~LLMAX Max. number of users (180) 
Entering New Users Into Time-Sharing 


USER'S 


user's courtesy call address, .LCC 


USER-SPECIFIED 


User-specified processor time limit 


UST 
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UST Assignments 

-Lxxxx Number of items in UST 

»LLNUE Number of words per UST entry 
UST Collect CUST 

CLEAR UST AND MAKE ACCOUNTING ENTRY 
Dynamic UST Generator DYUST 


ENTER NEW USER IN UST AND UPDATE NUQ LOOP 


Release UST RUST 


Clear UST and Make Accounting Entry TRMCU 


PASS UST TO SUBSYSTEM 
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164 
164 


80 


211 


(continued) 
Clear UST and Hake Accounting Entry TRMCU 
SET LINE NUMBER / INCREMENT IN UST 
UST GENERATION (TSSN) 


dee ae 


Release UST RUST 

Clear UST and Make Accounting Entry TRMCU 
RELEASE UST 

TSSN (Dynamic Ust, DYUST) 


UTILITY 


UTILITY ROUTINES (TSSI) 


VARIABLES 


Parameters / Variables 


WAITING 


-LSNUB SNUMB of batch job waiting 


WORD 


-LTTYS Remote status return word 
.LFLG2 Second flag word 

SCAN rUR nNOWN CUMMAND WUKD 
courtesy call word 

second flag word, .LFLG2 

Scan for Known Command Word SCAN2 


WORDS 


-LBUFS Number of words in line buffer 
-LLNUE Number of words per UST entry 


-LLWFE Number of words per file table entry 


~LASTT Swap I/O status - 2 words 


WRAPUP 


-LRAP Wrapup address 
TIME-SHARING WRAPUP 


WRITE 


READ / WRITE CORE FILE 


ZERO 


#S 


-LERRM Argument to PNTERR zero 


RELEASE #S LINKS 
Release #S Links RELSPC 


*SRC* TAP 


-LSYBC *SRC*TAP block count 
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1/8 


9AG 
2%90 


246 
247 


XAO 
o%7 


250 


255 


oOn~I ~~] 
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~CRXXX 


- CRLAL 
- CRPOQ 
- CRSNB 
- CRTSQ 


- LXXX 
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- LACPT 
- LADCW 
. LADW2 
- LASTT 
- LBACK 
- LBKMX 
- LBPTR 
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gate 
gate 
table 
gate 


Accept Indicator for Privileged Subsystem 
Max, Number Swap DCW's 

Swap DCWl and Block Number Cell 

Swap I/O Status - 2 Words 

Backward Pointer Priority Value 

Block Number Threshold for Scratch File 
DATANET 760 Buffer Pointer 


-LBRK Break Fault 
-LBRT Location of Abort, Reason Code 


- LBRTM 


GELBAR Time Setting 


-LBUF BUFFER R* T* Station Id 


- LBUFS 
- LCALS 


Number of Words in Line Buffer 
CALLSS Pushdown List 


~LCC Courtesy Call Return 


User's 
-~LCCTR 
-LCFIL 


Courtesy Call Address, .LCC 
DATANET 760 Character Count 
Ten-Word Blcok for Core File 


~-LCHG 1-12 Character BCI Charge Number 
-LDAT Current Loc of Data Bypass Count 


- LDCSS 
- LERRM 
- LFILE 
-LFILS 
- LFILS 
- LFLAG 
~ LFLG2 
. LFPAT 
- LFPES 
- LFTST 


Disc I/O Count at Subsystem Start 
Argument to PNTERR Zero 
Pointer to Program Stack and AFT 


Max, Number of Entries in File Table 
Forward Pointer Flags 

Second Flag Word 

Number of TSS User PAT 

TSS User Basic PAT Entry Size 
Accumulated Fault Status 


~LID User ID 


. LIMIT 
-LIMTR 
-LINCR 
- LINNO 
- LIOST 
- LKEYO 
. LKYSS 
.- LLMAX 
- LLNUE 
- LLTOT 
- LLWFE 
- LNDRC 
- LNEVT 


Subsystem Time Limit Set by User 
Time Limit Timer 

Increment For Auto Mode 

Line Number for Auto Mode 

I/O Status - Disc-Remote 

Time of Key I/O Start 

Key I/O Count At Subsystem Start 
MAX. Number of Users (180) 

Number of Words Per UST Entry 

Number of New Users Per Cycle 

Number of Words Per File Table Entry 
Number of Entries in DRL Count Table 
Number of Entries in Trace Table 


-LNPD Number of Entries in Program Descriptor List 


- LNTSF 
-LOSTI 
-LOSTR 


Number of TSS Executive Files 
OFFSET for Subsystem Indicators 
OFFSET for Subsystem Register 


157 
157 
257 
240 
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~Lxxx (continued) 


- LRPGD 
- LPRGS 
-LPRSS 


Number Entries in Program Descriptor 
Number Entries in Pushdown List 
Number Entries in CALLSS Pushdown List 


-LPSZ Size of Subsystem Patch Area 
~LRAP Wrapup Address 


- LRMAX 
- LSCLP 
- LSFTM 
- LSI ZE 
-LSNIO 
- LSNUB 
- LSPRT 
- LSPTS 
. LSTEM 
-LSTIO 


Number ot System errors Allowed Before Abort 
Line Service Previous Current Line Pointer 
4-Word LINSRV Pointer Disc/Drum R/W 

Base in TSS Size in Core 

Number of I/O Queues For TSS 

SNUMB of Batch Job Waiting 

Sum of Processor Time in Subsystem 

Sum of Processor Time this Subsystem Interaction 
Two-Word Temp. For Line Service 

No. CHAR/8 To Terminal No. File IO 


-LSTP Sum of User Processor Time 


- LSWAP 
- LSWTH 
SWITCH 
- LSYBC 
~LSZTM 
. LTALC 
. LTDES 


Block No. on Drum Actual Size 
Switch Word for User 

WORD (.LSWTH) 

*SRC*TAP Block Count 

Size and Time Exceed Fault 
Time of Day User Entered TSS 
File Description of PPT 


.LTIN Time of Day This interacti tarted 


ami Oa 
s i , 
4645S 2NCSDPACveiOni olaLr 


-LTIO Priority I/O This Interaction 


- LTIOS 
- LTIOS 


«LTLO At Last: Swap 
-LTIO At Last Swap 


-LTP Processor Time This Interaction 


- LTPS 
-LTPS 
- LTPSS 


-LTP At Last Swap 
-LTP At Last Swap 
Processor Time at Subsystem Start 


-LTRM Terminate Courtesy Call 


. LTSSV 
» LTTYS 
~LTTYS 
» LXXXX 


~MTIMS 


Saved I/O Status 
Remote Status Return Word 


Number of Items in UST 


Time-Sharing Executive (.MTIMS) Module 


. TXXXX 
-1T760 
-1T760 
- TAAUG 
. TABFN 
. TABST 
- TACOR 
~TCUT 
. TADMR 


DRUM Map (.TADMP) 


- TADMP 
. TADMT 


wu 
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-TXXxXx (continued) 


» TAFFN 10 
-TAFST 10 
. TAHOL 12 
. TAMAP 12 
- TAMPT 12 
. TAMSZ 10 
-TAREA 1 Pointers for TSSO Use, Initialization, ie 
- TASIO 10 
.TASSZ 12 
- TASTM 12 
-TATSZ 14 
- TAURG el 
. TAUST 247 
- TCBSZ 9 
» TCCMT 13 
-TCCMT Location 80 
« TCDAT Li 
. TCDEL 9 

~TCFIL 14 
~-TCFST 8 
~ TCLIM 9 
- TCLOC 8 
-TCLST 14 
« TCNOW 10 
«TCPD 9 
- TCPRT 9 
-TCTDC 14 
eCr yd 10 
. TCTMY 10 
-TCTSZ 14 
-TCUST 9 
~TCUST 247 
. TDBLK 11 
. TDBLT 11 
. TDDRL 13 
~TDRDR 11 
» TDRDT Li 
« TDREC Le 
» TDREL 12 
- TDSKS 14 
»TDSKT 14 
- TDSPC 12 
. TDSPD 12 
»TDSPL 12 
- TDWDR se 
- TDWDT 11 
. TELAL 8 
»TEPTS 8 
» TESNB 11 
. TESSB 8 
. TEVMK 14 
(. TEVMK) 18 
- TEVNT 14 
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- TFMAX 
TFPPE 
eTEPPE 
» TFSKL 
. TFBLK 
. TFMAX 
. TFMAX 
»TFPPE 
. TFPPE 
- TFSKL 
~ TFSY 
- TSTEM 
.TFILL 
- TLBDC 
~ TLDID 
- TLFLG 
» TLGRF 
. TLMON 
. TLNAA 
- TLNCT 
. TLNLM 
. TLNRJ 
. TLNUQ 
.» TLOLD 
. TLTLM 
.- TLTTM 
. TLTYN 
- TLUCT 
. TMAT 
- TMATL 
- TOSNB 
. TPNTP 
BLOCK .TPRGD 
- TQEXC 
-TQSYS 
« TRCNT 
- TRQUE 
Communication Region block, 
. TSDAT 
- TSMPT 
.» TSREG 
-TSSTR 
. TSTOD 
-TSTRC 
«TSTRI 
- TSWAP 
« TSWPK 
- TTERM 


.- TSCOM 
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